Merge branch 'upstream'
[sfrench/cifs-2.6.git] / drivers / scsi / libata-core.c
1 /*
2  *  libata-core.c - helper library for ATA
3  *
4  *  Maintained by:  Jeff Garzik <jgarzik@pobox.com>
5  *                  Please ALWAYS copy linux-ide@vger.kernel.org
6  *                  on emails.
7  *
8  *  Copyright 2003-2004 Red Hat, Inc.  All rights reserved.
9  *  Copyright 2003-2004 Jeff Garzik
10  *
11  *
12  *  This program is free software; you can redistribute it and/or modify
13  *  it under the terms of the GNU General Public License as published by
14  *  the Free Software Foundation; either version 2, or (at your option)
15  *  any later version.
16  *
17  *  This program is distributed in the hope that it will be useful,
18  *  but WITHOUT ANY WARRANTY; without even the implied warranty of
19  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
20  *  GNU General Public License for more details.
21  *
22  *  You should have received a copy of the GNU General Public License
23  *  along with this program; see the file COPYING.  If not, write to
24  *  the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
25  *
26  *
27  *  libata documentation is available via 'make {ps|pdf}docs',
28  *  as Documentation/DocBook/libata.*
29  *
30  *  Hardware documentation available from http://www.t13.org/ and
31  *  http://www.sata-io.org/
32  *
33  */
34
35 #include <linux/config.h>
36 #include <linux/kernel.h>
37 #include <linux/module.h>
38 #include <linux/pci.h>
39 #include <linux/init.h>
40 #include <linux/list.h>
41 #include <linux/mm.h>
42 #include <linux/highmem.h>
43 #include <linux/spinlock.h>
44 #include <linux/blkdev.h>
45 #include <linux/delay.h>
46 #include <linux/timer.h>
47 #include <linux/interrupt.h>
48 #include <linux/completion.h>
49 #include <linux/suspend.h>
50 #include <linux/workqueue.h>
51 #include <linux/jiffies.h>
52 #include <linux/scatterlist.h>
53 #include <scsi/scsi.h>
54 #include "scsi_priv.h"
55 #include <scsi/scsi_cmnd.h>
56 #include <scsi/scsi_host.h>
57 #include <linux/libata.h>
58 #include <asm/io.h>
59 #include <asm/semaphore.h>
60 #include <asm/byteorder.h>
61
62 #include "libata.h"
63
64 static unsigned int ata_dev_init_params(struct ata_port *ap,
65                                         struct ata_device *dev);
66 static void ata_set_mode(struct ata_port *ap);
67 static void ata_dev_set_xfermode(struct ata_port *ap, struct ata_device *dev);
68 static unsigned int ata_get_mode_mask(const struct ata_port *ap, int shift);
69 static int fgb(u32 bitmap);
70 static int ata_choose_xfer_mode(const struct ata_port *ap,
71                                 u8 *xfer_mode_out,
72                                 unsigned int *xfer_shift_out);
73 static void ata_pio_error(struct ata_port *ap);
74
75 static unsigned int ata_unique_id = 1;
76 static struct workqueue_struct *ata_wq;
77
78 int atapi_enabled = 0;
79 module_param(atapi_enabled, int, 0444);
80 MODULE_PARM_DESC(atapi_enabled, "Enable discovery of ATAPI devices (0=off, 1=on)");
81
82 MODULE_AUTHOR("Jeff Garzik");
83 MODULE_DESCRIPTION("Library module for ATA devices");
84 MODULE_LICENSE("GPL");
85 MODULE_VERSION(DRV_VERSION);
86
87
88 /**
89  *      ata_tf_to_fis - Convert ATA taskfile to SATA FIS structure
90  *      @tf: Taskfile to convert
91  *      @fis: Buffer into which data will output
92  *      @pmp: Port multiplier port
93  *
94  *      Converts a standard ATA taskfile to a Serial ATA
95  *      FIS structure (Register - Host to Device).
96  *
97  *      LOCKING:
98  *      Inherited from caller.
99  */
100
101 void ata_tf_to_fis(const struct ata_taskfile *tf, u8 *fis, u8 pmp)
102 {
103         fis[0] = 0x27;  /* Register - Host to Device FIS */
104         fis[1] = (pmp & 0xf) | (1 << 7); /* Port multiplier number,
105                                             bit 7 indicates Command FIS */
106         fis[2] = tf->command;
107         fis[3] = tf->feature;
108
109         fis[4] = tf->lbal;
110         fis[5] = tf->lbam;
111         fis[6] = tf->lbah;
112         fis[7] = tf->device;
113
114         fis[8] = tf->hob_lbal;
115         fis[9] = tf->hob_lbam;
116         fis[10] = tf->hob_lbah;
117         fis[11] = tf->hob_feature;
118
119         fis[12] = tf->nsect;
120         fis[13] = tf->hob_nsect;
121         fis[14] = 0;
122         fis[15] = tf->ctl;
123
124         fis[16] = 0;
125         fis[17] = 0;
126         fis[18] = 0;
127         fis[19] = 0;
128 }
129
130 /**
131  *      ata_tf_from_fis - Convert SATA FIS to ATA taskfile
132  *      @fis: Buffer from which data will be input
133  *      @tf: Taskfile to output
134  *
135  *      Converts a serial ATA FIS structure to a standard ATA taskfile.
136  *
137  *      LOCKING:
138  *      Inherited from caller.
139  */
140
141 void ata_tf_from_fis(const u8 *fis, struct ata_taskfile *tf)
142 {
143         tf->command     = fis[2];       /* status */
144         tf->feature     = fis[3];       /* error */
145
146         tf->lbal        = fis[4];
147         tf->lbam        = fis[5];
148         tf->lbah        = fis[6];
149         tf->device      = fis[7];
150
151         tf->hob_lbal    = fis[8];
152         tf->hob_lbam    = fis[9];
153         tf->hob_lbah    = fis[10];
154
155         tf->nsect       = fis[12];
156         tf->hob_nsect   = fis[13];
157 }
158
159 static const u8 ata_rw_cmds[] = {
160         /* pio multi */
161         ATA_CMD_READ_MULTI,
162         ATA_CMD_WRITE_MULTI,
163         ATA_CMD_READ_MULTI_EXT,
164         ATA_CMD_WRITE_MULTI_EXT,
165         0,
166         0,
167         0,
168         ATA_CMD_WRITE_MULTI_FUA_EXT,
169         /* pio */
170         ATA_CMD_PIO_READ,
171         ATA_CMD_PIO_WRITE,
172         ATA_CMD_PIO_READ_EXT,
173         ATA_CMD_PIO_WRITE_EXT,
174         0,
175         0,
176         0,
177         0,
178         /* dma */
179         ATA_CMD_READ,
180         ATA_CMD_WRITE,
181         ATA_CMD_READ_EXT,
182         ATA_CMD_WRITE_EXT,
183         0,
184         0,
185         0,
186         ATA_CMD_WRITE_FUA_EXT
187 };
188
189 /**
190  *      ata_rwcmd_protocol - set taskfile r/w commands and protocol
191  *      @qc: command to examine and configure
192  *
193  *      Examine the device configuration and tf->flags to calculate 
194  *      the proper read/write commands and protocol to use.
195  *
196  *      LOCKING:
197  *      caller.
198  */
199 int ata_rwcmd_protocol(struct ata_queued_cmd *qc)
200 {
201         struct ata_taskfile *tf = &qc->tf;
202         struct ata_device *dev = qc->dev;
203         u8 cmd;
204
205         int index, fua, lba48, write;
206  
207         fua = (tf->flags & ATA_TFLAG_FUA) ? 4 : 0;
208         lba48 = (tf->flags & ATA_TFLAG_LBA48) ? 2 : 0;
209         write = (tf->flags & ATA_TFLAG_WRITE) ? 1 : 0;
210
211         if (dev->flags & ATA_DFLAG_PIO) {
212                 tf->protocol = ATA_PROT_PIO;
213                 index = dev->multi_count ? 0 : 8;
214         } else if (lba48 && (qc->ap->flags & ATA_FLAG_PIO_LBA48)) {
215                 /* Unable to use DMA due to host limitation */
216                 tf->protocol = ATA_PROT_PIO;
217                 index = dev->multi_count ? 0 : 8;
218         } else {
219                 tf->protocol = ATA_PROT_DMA;
220                 index = 16;
221         }
222
223         cmd = ata_rw_cmds[index + fua + lba48 + write];
224         if (cmd) {
225                 tf->command = cmd;
226                 return 0;
227         }
228         return -1;
229 }
230
231 static const char * const xfer_mode_str[] = {
232         "UDMA/16",
233         "UDMA/25",
234         "UDMA/33",
235         "UDMA/44",
236         "UDMA/66",
237         "UDMA/100",
238         "UDMA/133",
239         "UDMA7",
240         "MWDMA0",
241         "MWDMA1",
242         "MWDMA2",
243         "PIO0",
244         "PIO1",
245         "PIO2",
246         "PIO3",
247         "PIO4",
248 };
249
250 /**
251  *      ata_udma_string - convert UDMA bit offset to string
252  *      @mask: mask of bits supported; only highest bit counts.
253  *
254  *      Determine string which represents the highest speed
255  *      (highest bit in @udma_mask).
256  *
257  *      LOCKING:
258  *      None.
259  *
260  *      RETURNS:
261  *      Constant C string representing highest speed listed in
262  *      @udma_mask, or the constant C string "<n/a>".
263  */
264
265 static const char *ata_mode_string(unsigned int mask)
266 {
267         int i;
268
269         for (i = 7; i >= 0; i--)
270                 if (mask & (1 << i))
271                         goto out;
272         for (i = ATA_SHIFT_MWDMA + 2; i >= ATA_SHIFT_MWDMA; i--)
273                 if (mask & (1 << i))
274                         goto out;
275         for (i = ATA_SHIFT_PIO + 4; i >= ATA_SHIFT_PIO; i--)
276                 if (mask & (1 << i))
277                         goto out;
278
279         return "<n/a>";
280
281 out:
282         return xfer_mode_str[i];
283 }
284
285 /**
286  *      ata_pio_devchk - PATA device presence detection
287  *      @ap: ATA channel to examine
288  *      @device: Device to examine (starting at zero)
289  *
290  *      This technique was originally described in
291  *      Hale Landis's ATADRVR (www.ata-atapi.com), and
292  *      later found its way into the ATA/ATAPI spec.
293  *
294  *      Write a pattern to the ATA shadow registers,
295  *      and if a device is present, it will respond by
296  *      correctly storing and echoing back the
297  *      ATA shadow register contents.
298  *
299  *      LOCKING:
300  *      caller.
301  */
302
303 static unsigned int ata_pio_devchk(struct ata_port *ap,
304                                    unsigned int device)
305 {
306         struct ata_ioports *ioaddr = &ap->ioaddr;
307         u8 nsect, lbal;
308
309         ap->ops->dev_select(ap, device);
310
311         outb(0x55, ioaddr->nsect_addr);
312         outb(0xaa, ioaddr->lbal_addr);
313
314         outb(0xaa, ioaddr->nsect_addr);
315         outb(0x55, ioaddr->lbal_addr);
316
317         outb(0x55, ioaddr->nsect_addr);
318         outb(0xaa, ioaddr->lbal_addr);
319
320         nsect = inb(ioaddr->nsect_addr);
321         lbal = inb(ioaddr->lbal_addr);
322
323         if ((nsect == 0x55) && (lbal == 0xaa))
324                 return 1;       /* we found a device */
325
326         return 0;               /* nothing found */
327 }
328
329 /**
330  *      ata_mmio_devchk - PATA device presence detection
331  *      @ap: ATA channel to examine
332  *      @device: Device to examine (starting at zero)
333  *
334  *      This technique was originally described in
335  *      Hale Landis's ATADRVR (www.ata-atapi.com), and
336  *      later found its way into the ATA/ATAPI spec.
337  *
338  *      Write a pattern to the ATA shadow registers,
339  *      and if a device is present, it will respond by
340  *      correctly storing and echoing back the
341  *      ATA shadow register contents.
342  *
343  *      LOCKING:
344  *      caller.
345  */
346
347 static unsigned int ata_mmio_devchk(struct ata_port *ap,
348                                     unsigned int device)
349 {
350         struct ata_ioports *ioaddr = &ap->ioaddr;
351         u8 nsect, lbal;
352
353         ap->ops->dev_select(ap, device);
354
355         writeb(0x55, (void __iomem *) ioaddr->nsect_addr);
356         writeb(0xaa, (void __iomem *) ioaddr->lbal_addr);
357
358         writeb(0xaa, (void __iomem *) ioaddr->nsect_addr);
359         writeb(0x55, (void __iomem *) ioaddr->lbal_addr);
360
361         writeb(0x55, (void __iomem *) ioaddr->nsect_addr);
362         writeb(0xaa, (void __iomem *) ioaddr->lbal_addr);
363
364         nsect = readb((void __iomem *) ioaddr->nsect_addr);
365         lbal = readb((void __iomem *) ioaddr->lbal_addr);
366
367         if ((nsect == 0x55) && (lbal == 0xaa))
368                 return 1;       /* we found a device */
369
370         return 0;               /* nothing found */
371 }
372
373 /**
374  *      ata_devchk - PATA device presence detection
375  *      @ap: ATA channel to examine
376  *      @device: Device to examine (starting at zero)
377  *
378  *      Dispatch ATA device presence detection, depending
379  *      on whether we are using PIO or MMIO to talk to the
380  *      ATA shadow registers.
381  *
382  *      LOCKING:
383  *      caller.
384  */
385
386 static unsigned int ata_devchk(struct ata_port *ap,
387                                     unsigned int device)
388 {
389         if (ap->flags & ATA_FLAG_MMIO)
390                 return ata_mmio_devchk(ap, device);
391         return ata_pio_devchk(ap, device);
392 }
393
394 /**
395  *      ata_dev_classify - determine device type based on ATA-spec signature
396  *      @tf: ATA taskfile register set for device to be identified
397  *
398  *      Determine from taskfile register contents whether a device is
399  *      ATA or ATAPI, as per "Signature and persistence" section
400  *      of ATA/PI spec (volume 1, sect 5.14).
401  *
402  *      LOCKING:
403  *      None.
404  *
405  *      RETURNS:
406  *      Device type, %ATA_DEV_ATA, %ATA_DEV_ATAPI, or %ATA_DEV_UNKNOWN
407  *      the event of failure.
408  */
409
410 unsigned int ata_dev_classify(const struct ata_taskfile *tf)
411 {
412         /* Apple's open source Darwin code hints that some devices only
413          * put a proper signature into the LBA mid/high registers,
414          * So, we only check those.  It's sufficient for uniqueness.
415          */
416
417         if (((tf->lbam == 0) && (tf->lbah == 0)) ||
418             ((tf->lbam == 0x3c) && (tf->lbah == 0xc3))) {
419                 DPRINTK("found ATA device by sig\n");
420                 return ATA_DEV_ATA;
421         }
422
423         if (((tf->lbam == 0x14) && (tf->lbah == 0xeb)) ||
424             ((tf->lbam == 0x69) && (tf->lbah == 0x96))) {
425                 DPRINTK("found ATAPI device by sig\n");
426                 return ATA_DEV_ATAPI;
427         }
428
429         DPRINTK("unknown device\n");
430         return ATA_DEV_UNKNOWN;
431 }
432
433 /**
434  *      ata_dev_try_classify - Parse returned ATA device signature
435  *      @ap: ATA channel to examine
436  *      @device: Device to examine (starting at zero)
437  *      @r_err: Value of error register on completion
438  *
439  *      After an event -- SRST, E.D.D., or SATA COMRESET -- occurs,
440  *      an ATA/ATAPI-defined set of values is placed in the ATA
441  *      shadow registers, indicating the results of device detection
442  *      and diagnostics.
443  *
444  *      Select the ATA device, and read the values from the ATA shadow
445  *      registers.  Then parse according to the Error register value,
446  *      and the spec-defined values examined by ata_dev_classify().
447  *
448  *      LOCKING:
449  *      caller.
450  *
451  *      RETURNS:
452  *      Device type - %ATA_DEV_ATA, %ATA_DEV_ATAPI or %ATA_DEV_NONE.
453  */
454
455 static unsigned int
456 ata_dev_try_classify(struct ata_port *ap, unsigned int device, u8 *r_err)
457 {
458         struct ata_taskfile tf;
459         unsigned int class;
460         u8 err;
461
462         ap->ops->dev_select(ap, device);
463
464         memset(&tf, 0, sizeof(tf));
465
466         ap->ops->tf_read(ap, &tf);
467         err = tf.feature;
468         if (r_err)
469                 *r_err = err;
470
471         /* see if device passed diags */
472         if (err == 1)
473                 /* do nothing */ ;
474         else if ((device == 0) && (err == 0x81))
475                 /* do nothing */ ;
476         else
477                 return ATA_DEV_NONE;
478
479         /* determine if device is ATA or ATAPI */
480         class = ata_dev_classify(&tf);
481
482         if (class == ATA_DEV_UNKNOWN)
483                 return ATA_DEV_NONE;
484         if ((class == ATA_DEV_ATA) && (ata_chk_status(ap) == 0))
485                 return ATA_DEV_NONE;
486         return class;
487 }
488
489 /**
490  *      ata_id_string - Convert IDENTIFY DEVICE page into string
491  *      @id: IDENTIFY DEVICE results we will examine
492  *      @s: string into which data is output
493  *      @ofs: offset into identify device page
494  *      @len: length of string to return. must be an even number.
495  *
496  *      The strings in the IDENTIFY DEVICE page are broken up into
497  *      16-bit chunks.  Run through the string, and output each
498  *      8-bit chunk linearly, regardless of platform.
499  *
500  *      LOCKING:
501  *      caller.
502  */
503
504 void ata_id_string(const u16 *id, unsigned char *s,
505                    unsigned int ofs, unsigned int len)
506 {
507         unsigned int c;
508
509         while (len > 0) {
510                 c = id[ofs] >> 8;
511                 *s = c;
512                 s++;
513
514                 c = id[ofs] & 0xff;
515                 *s = c;
516                 s++;
517
518                 ofs++;
519                 len -= 2;
520         }
521 }
522
523 /**
524  *      ata_id_c_string - Convert IDENTIFY DEVICE page into C string
525  *      @id: IDENTIFY DEVICE results we will examine
526  *      @s: string into which data is output
527  *      @ofs: offset into identify device page
528  *      @len: length of string to return. must be an odd number.
529  *
530  *      This function is identical to ata_id_string except that it
531  *      trims trailing spaces and terminates the resulting string with
532  *      null.  @len must be actual maximum length (even number) + 1.
533  *
534  *      LOCKING:
535  *      caller.
536  */
537 void ata_id_c_string(const u16 *id, unsigned char *s,
538                      unsigned int ofs, unsigned int len)
539 {
540         unsigned char *p;
541
542         WARN_ON(!(len & 1));
543
544         ata_id_string(id, s, ofs, len - 1);
545
546         p = s + strnlen(s, len - 1);
547         while (p > s && p[-1] == ' ')
548                 p--;
549         *p = '\0';
550 }
551
552 static u64 ata_id_n_sectors(const u16 *id)
553 {
554         if (ata_id_has_lba(id)) {
555                 if (ata_id_has_lba48(id))
556                         return ata_id_u64(id, 100);
557                 else
558                         return ata_id_u32(id, 60);
559         } else {
560                 if (ata_id_current_chs_valid(id))
561                         return ata_id_u32(id, 57);
562                 else
563                         return id[1] * id[3] * id[6];
564         }
565 }
566
567 /**
568  *      ata_noop_dev_select - Select device 0/1 on ATA bus
569  *      @ap: ATA channel to manipulate
570  *      @device: ATA device (numbered from zero) to select
571  *
572  *      This function performs no actual function.
573  *
574  *      May be used as the dev_select() entry in ata_port_operations.
575  *
576  *      LOCKING:
577  *      caller.
578  */
579 void ata_noop_dev_select (struct ata_port *ap, unsigned int device)
580 {
581 }
582
583
584 /**
585  *      ata_std_dev_select - Select device 0/1 on ATA bus
586  *      @ap: ATA channel to manipulate
587  *      @device: ATA device (numbered from zero) to select
588  *
589  *      Use the method defined in the ATA specification to
590  *      make either device 0, or device 1, active on the
591  *      ATA channel.  Works with both PIO and MMIO.
592  *
593  *      May be used as the dev_select() entry in ata_port_operations.
594  *
595  *      LOCKING:
596  *      caller.
597  */
598
599 void ata_std_dev_select (struct ata_port *ap, unsigned int device)
600 {
601         u8 tmp;
602
603         if (device == 0)
604                 tmp = ATA_DEVICE_OBS;
605         else
606                 tmp = ATA_DEVICE_OBS | ATA_DEV1;
607
608         if (ap->flags & ATA_FLAG_MMIO) {
609                 writeb(tmp, (void __iomem *) ap->ioaddr.device_addr);
610         } else {
611                 outb(tmp, ap->ioaddr.device_addr);
612         }
613         ata_pause(ap);          /* needed; also flushes, for mmio */
614 }
615
616 /**
617  *      ata_dev_select - Select device 0/1 on ATA bus
618  *      @ap: ATA channel to manipulate
619  *      @device: ATA device (numbered from zero) to select
620  *      @wait: non-zero to wait for Status register BSY bit to clear
621  *      @can_sleep: non-zero if context allows sleeping
622  *
623  *      Use the method defined in the ATA specification to
624  *      make either device 0, or device 1, active on the
625  *      ATA channel.
626  *
627  *      This is a high-level version of ata_std_dev_select(),
628  *      which additionally provides the services of inserting
629  *      the proper pauses and status polling, where needed.
630  *
631  *      LOCKING:
632  *      caller.
633  */
634
635 void ata_dev_select(struct ata_port *ap, unsigned int device,
636                            unsigned int wait, unsigned int can_sleep)
637 {
638         VPRINTK("ENTER, ata%u: device %u, wait %u\n",
639                 ap->id, device, wait);
640
641         if (wait)
642                 ata_wait_idle(ap);
643
644         ap->ops->dev_select(ap, device);
645
646         if (wait) {
647                 if (can_sleep && ap->device[device].class == ATA_DEV_ATAPI)
648                         msleep(150);
649                 ata_wait_idle(ap);
650         }
651 }
652
653 /**
654  *      ata_dump_id - IDENTIFY DEVICE info debugging output
655  *      @id: IDENTIFY DEVICE page to dump
656  *
657  *      Dump selected 16-bit words from the given IDENTIFY DEVICE
658  *      page.
659  *
660  *      LOCKING:
661  *      caller.
662  */
663
664 static inline void ata_dump_id(const u16 *id)
665 {
666         DPRINTK("49==0x%04x  "
667                 "53==0x%04x  "
668                 "63==0x%04x  "
669                 "64==0x%04x  "
670                 "75==0x%04x  \n",
671                 id[49],
672                 id[53],
673                 id[63],
674                 id[64],
675                 id[75]);
676         DPRINTK("80==0x%04x  "
677                 "81==0x%04x  "
678                 "82==0x%04x  "
679                 "83==0x%04x  "
680                 "84==0x%04x  \n",
681                 id[80],
682                 id[81],
683                 id[82],
684                 id[83],
685                 id[84]);
686         DPRINTK("88==0x%04x  "
687                 "93==0x%04x\n",
688                 id[88],
689                 id[93]);
690 }
691
692 /*
693  *      Compute the PIO modes available for this device. This is not as
694  *      trivial as it seems if we must consider early devices correctly.
695  *
696  *      FIXME: pre IDE drive timing (do we care ?). 
697  */
698
699 static unsigned int ata_pio_modes(const struct ata_device *adev)
700 {
701         u16 modes;
702
703         /* Usual case. Word 53 indicates word 64 is valid */
704         if (adev->id[ATA_ID_FIELD_VALID] & (1 << 1)) {
705                 modes = adev->id[ATA_ID_PIO_MODES] & 0x03;
706                 modes <<= 3;
707                 modes |= 0x7;
708                 return modes;
709         }
710
711         /* If word 64 isn't valid then Word 51 high byte holds the PIO timing
712            number for the maximum. Turn it into a mask and return it */
713         modes = (2 << ((adev->id[ATA_ID_OLD_PIO_MODES] >> 8) & 0xFF)) - 1 ;
714         return modes;
715         /* But wait.. there's more. Design your standards by committee and
716            you too can get a free iordy field to process. However its the 
717            speeds not the modes that are supported... Note drivers using the
718            timing API will get this right anyway */
719 }
720
721 static inline void
722 ata_queue_pio_task(struct ata_port *ap)
723 {
724         if (!(ap->flags & ATA_FLAG_FLUSH_PIO_TASK))
725                 queue_work(ata_wq, &ap->pio_task);
726 }
727
728 static inline void
729 ata_queue_delayed_pio_task(struct ata_port *ap, unsigned long delay)
730 {
731         if (!(ap->flags & ATA_FLAG_FLUSH_PIO_TASK))
732                 queue_delayed_work(ata_wq, &ap->pio_task, delay);
733 }
734
735 /**
736  *      ata_flush_pio_tasks - Flush pio_task
737  *      @ap: the target ata_port
738  *
739  *      After this function completes, pio_task is
740  *      guranteed not to be running or scheduled.
741  *
742  *      LOCKING:
743  *      Kernel thread context (may sleep)
744  */
745
746 static void ata_flush_pio_tasks(struct ata_port *ap)
747 {
748         int tmp = 0;
749         unsigned long flags;
750
751         DPRINTK("ENTER\n");
752
753         spin_lock_irqsave(&ap->host_set->lock, flags);
754         ap->flags |= ATA_FLAG_FLUSH_PIO_TASK;
755         spin_unlock_irqrestore(&ap->host_set->lock, flags);
756
757         DPRINTK("flush #1\n");
758         flush_workqueue(ata_wq);
759
760         /*
761          * At this point, if a task is running, it's guaranteed to see
762          * the FLUSH flag; thus, it will never queue pio tasks again.
763          * Cancel and flush.
764          */
765         tmp |= cancel_delayed_work(&ap->pio_task);
766         if (!tmp) {
767                 DPRINTK("flush #2\n");
768                 flush_workqueue(ata_wq);
769         }
770
771         spin_lock_irqsave(&ap->host_set->lock, flags);
772         ap->flags &= ~ATA_FLAG_FLUSH_PIO_TASK;
773         spin_unlock_irqrestore(&ap->host_set->lock, flags);
774
775         DPRINTK("EXIT\n");
776 }
777
778 void ata_qc_complete_internal(struct ata_queued_cmd *qc)
779 {
780         struct completion *waiting = qc->private_data;
781
782         qc->ap->ops->tf_read(qc->ap, &qc->tf);
783         complete(waiting);
784 }
785
786 /**
787  *      ata_exec_internal - execute libata internal command
788  *      @ap: Port to which the command is sent
789  *      @dev: Device to which the command is sent
790  *      @tf: Taskfile registers for the command and the result
791  *      @dma_dir: Data tranfer direction of the command
792  *      @buf: Data buffer of the command
793  *      @buflen: Length of data buffer
794  *
795  *      Executes libata internal command with timeout.  @tf contains
796  *      command on entry and result on return.  Timeout and error
797  *      conditions are reported via return value.  No recovery action
798  *      is taken after a command times out.  It's caller's duty to
799  *      clean up after timeout.
800  *
801  *      LOCKING:
802  *      None.  Should be called with kernel context, might sleep.
803  */
804
805 static unsigned
806 ata_exec_internal(struct ata_port *ap, struct ata_device *dev,
807                   struct ata_taskfile *tf,
808                   int dma_dir, void *buf, unsigned int buflen)
809 {
810         u8 command = tf->command;
811         struct ata_queued_cmd *qc;
812         DECLARE_COMPLETION(wait);
813         unsigned long flags;
814         unsigned int err_mask;
815
816         spin_lock_irqsave(&ap->host_set->lock, flags);
817
818         qc = ata_qc_new_init(ap, dev);
819         BUG_ON(qc == NULL);
820
821         qc->tf = *tf;
822         qc->dma_dir = dma_dir;
823         if (dma_dir != DMA_NONE) {
824                 ata_sg_init_one(qc, buf, buflen);
825                 qc->nsect = buflen / ATA_SECT_SIZE;
826         }
827
828         qc->private_data = &wait;
829         qc->complete_fn = ata_qc_complete_internal;
830
831         qc->err_mask = ata_qc_issue(qc);
832         if (qc->err_mask)
833                 ata_qc_complete(qc);
834
835         spin_unlock_irqrestore(&ap->host_set->lock, flags);
836
837         if (!wait_for_completion_timeout(&wait, ATA_TMOUT_INTERNAL)) {
838                 spin_lock_irqsave(&ap->host_set->lock, flags);
839
840                 /* We're racing with irq here.  If we lose, the
841                  * following test prevents us from completing the qc
842                  * again.  If completion irq occurs after here but
843                  * before the caller cleans up, it will result in a
844                  * spurious interrupt.  We can live with that.
845                  */
846                 if (qc->flags & ATA_QCFLAG_ACTIVE) {
847                         qc->err_mask = AC_ERR_TIMEOUT;
848                         ata_qc_complete(qc);
849                         printk(KERN_WARNING "ata%u: qc timeout (cmd 0x%x)\n",
850                                ap->id, command);
851                 }
852
853                 spin_unlock_irqrestore(&ap->host_set->lock, flags);
854         }
855
856         *tf = qc->tf;
857         err_mask = qc->err_mask;
858
859         ata_qc_free(qc);
860
861         return err_mask;
862 }
863
864 /**
865  *      ata_pio_need_iordy      -       check if iordy needed
866  *      @adev: ATA device
867  *
868  *      Check if the current speed of the device requires IORDY. Used
869  *      by various controllers for chip configuration.
870  */
871
872 unsigned int ata_pio_need_iordy(const struct ata_device *adev)
873 {
874         int pio;
875         int speed = adev->pio_mode - XFER_PIO_0;
876
877         if (speed < 2)
878                 return 0;
879         if (speed > 2)
880                 return 1;
881                 
882         /* If we have no drive specific rule, then PIO 2 is non IORDY */
883
884         if (adev->id[ATA_ID_FIELD_VALID] & 2) { /* EIDE */
885                 pio = adev->id[ATA_ID_EIDE_PIO];
886                 /* Is the speed faster than the drive allows non IORDY ? */
887                 if (pio) {
888                         /* This is cycle times not frequency - watch the logic! */
889                         if (pio > 240)  /* PIO2 is 240nS per cycle */
890                                 return 1;
891                         return 0;
892                 }
893         }
894         return 0;
895 }
896
897 /**
898  *      ata_dev_read_id - Read ID data from the specified device
899  *      @ap: port on which target device resides
900  *      @dev: target device
901  *      @p_class: pointer to class of the target device (may be changed)
902  *      @post_reset: is this read ID post-reset?
903  *      @id: buffer to fill IDENTIFY page into
904  *
905  *      Read ID data from the specified device.  ATA_CMD_ID_ATA is
906  *      performed on ATA devices and ATA_CMD_ID_ATAPI on ATAPI
907  *      devices.  This function also takes care of EDD signature
908  *      misreporting (to be removed once EDD support is gone) and
909  *      issues ATA_CMD_INIT_DEV_PARAMS for pre-ATA4 drives.
910  *
911  *      LOCKING:
912  *      Kernel thread context (may sleep)
913  *
914  *      RETURNS:
915  *      0 on success, -errno otherwise.
916  */
917 static int ata_dev_read_id(struct ata_port *ap, struct ata_device *dev,
918                            unsigned int *p_class, int post_reset, u16 *id)
919 {
920         unsigned int class = *p_class;
921         unsigned int using_edd;
922         struct ata_taskfile tf;
923         unsigned int err_mask = 0;
924         const char *reason;
925         int rc;
926
927         DPRINTK("ENTER, host %u, dev %u\n", ap->id, dev->devno);
928
929         if (ap->ops->probe_reset ||
930             ap->flags & (ATA_FLAG_SRST | ATA_FLAG_SATA_RESET))
931                 using_edd = 0;
932         else
933                 using_edd = 1;
934
935         ata_dev_select(ap, dev->devno, 1, 1); /* select device 0/1 */
936
937  retry:
938         ata_tf_init(ap, &tf, dev->devno);
939
940         switch (class) {
941         case ATA_DEV_ATA:
942                 tf.command = ATA_CMD_ID_ATA;
943                 break;
944         case ATA_DEV_ATAPI:
945                 tf.command = ATA_CMD_ID_ATAPI;
946                 break;
947         default:
948                 rc = -ENODEV;
949                 reason = "unsupported class";
950                 goto err_out;
951         }
952
953         tf.protocol = ATA_PROT_PIO;
954
955         err_mask = ata_exec_internal(ap, dev, &tf, DMA_FROM_DEVICE,
956                                      id, sizeof(id[0]) * ATA_ID_WORDS);
957
958         if (err_mask) {
959                 rc = -EIO;
960                 reason = "I/O error";
961
962                 if (err_mask & ~AC_ERR_DEV)
963                         goto err_out;
964
965                 /*
966                  * arg!  EDD works for all test cases, but seems to return
967                  * the ATA signature for some ATAPI devices.  Until the
968                  * reason for this is found and fixed, we fix up the mess
969                  * here.  If IDENTIFY DEVICE returns command aborted
970                  * (as ATAPI devices do), then we issue an
971                  * IDENTIFY PACKET DEVICE.
972                  *
973                  * ATA software reset (SRST, the default) does not appear
974                  * to have this problem.
975                  */
976                 if ((using_edd) && (class == ATA_DEV_ATA)) {
977                         u8 err = tf.feature;
978                         if (err & ATA_ABORTED) {
979                                 class = ATA_DEV_ATAPI;
980                                 goto retry;
981                         }
982                 }
983                 goto err_out;
984         }
985
986         swap_buf_le16(id, ATA_ID_WORDS);
987
988         /* print device capabilities */
989         printk(KERN_DEBUG "ata%u: dev %u cfg "
990                "49:%04x 82:%04x 83:%04x 84:%04x 85:%04x 86:%04x 87:%04x 88:%04x\n",
991                ap->id, dev->devno,
992                id[49], id[82], id[83], id[84], id[85], id[86], id[87], id[88]);
993
994         /* sanity check */
995         if ((class == ATA_DEV_ATA) != ata_id_is_ata(id)) {
996                 rc = -EINVAL;
997                 reason = "device reports illegal type";
998                 goto err_out;
999         }
1000
1001         if (post_reset && class == ATA_DEV_ATA) {
1002                 /*
1003                  * The exact sequence expected by certain pre-ATA4 drives is:
1004                  * SRST RESET
1005                  * IDENTIFY
1006                  * INITIALIZE DEVICE PARAMETERS
1007                  * anything else..
1008                  * Some drives were very specific about that exact sequence.
1009                  */
1010                 if (ata_id_major_version(id) < 4 || !ata_id_has_lba(id)) {
1011                         err_mask = ata_dev_init_params(ap, dev);
1012                         if (err_mask) {
1013                                 rc = -EIO;
1014                                 reason = "INIT_DEV_PARAMS failed";
1015                                 goto err_out;
1016                         }
1017
1018                         /* current CHS translation info (id[53-58]) might be
1019                          * changed. reread the identify device info.
1020                          */
1021                         post_reset = 0;
1022                         goto retry;
1023                 }
1024         }
1025
1026         *p_class = class;
1027         return 0;
1028
1029  err_out:
1030         printk(KERN_WARNING "ata%u: dev %u failed to IDENTIFY (%s)\n",
1031                ap->id, dev->devno, reason);
1032         kfree(id);
1033         return rc;
1034 }
1035
1036 /**
1037  *      ata_dev_identify - obtain IDENTIFY x DEVICE page
1038  *      @ap: port on which device we wish to probe resides
1039  *      @device: device bus address, starting at zero
1040  *
1041  *      Following bus reset, we issue the IDENTIFY [PACKET] DEVICE
1042  *      command, and read back the 512-byte device information page.
1043  *      The device information page is fed to us via the standard
1044  *      PIO-IN protocol, but we hand-code it here. (TODO: investigate
1045  *      using standard PIO-IN paths)
1046  *
1047  *      After reading the device information page, we use several
1048  *      bits of information from it to initialize data structures
1049  *      that will be used during the lifetime of the ata_device.
1050  *      Other data from the info page is used to disqualify certain
1051  *      older ATA devices we do not wish to support.
1052  *
1053  *      LOCKING:
1054  *      Inherited from caller.  Some functions called by this function
1055  *      obtain the host_set lock.
1056  */
1057
1058 static void ata_dev_identify(struct ata_port *ap, unsigned int device)
1059 {
1060         struct ata_device *dev = &ap->device[device];
1061         unsigned long xfer_modes;
1062         int i, rc;
1063
1064         if (!ata_dev_present(dev)) {
1065                 DPRINTK("ENTER/EXIT (host %u, dev %u) -- nodev\n",
1066                         ap->id, device);
1067                 return;
1068         }
1069
1070         DPRINTK("ENTER, host %u, dev %u\n", ap->id, device);
1071
1072         rc = ata_dev_read_id(ap, dev, &dev->class, 1, dev->id);
1073         if (rc)
1074                 goto err_out;
1075
1076         /*
1077          * common ATA, ATAPI feature tests
1078          */
1079
1080         /* we require DMA support (bits 8 of word 49) */
1081         if (!ata_id_has_dma(dev->id)) {
1082                 printk(KERN_DEBUG "ata%u: no dma\n", ap->id);
1083                 goto err_out_nosup;
1084         }
1085
1086         /* quick-n-dirty find max transfer mode; for printk only */
1087         xfer_modes = dev->id[ATA_ID_UDMA_MODES];
1088         if (!xfer_modes)
1089                 xfer_modes = (dev->id[ATA_ID_MWDMA_MODES]) << ATA_SHIFT_MWDMA;
1090         if (!xfer_modes)
1091                 xfer_modes = ata_pio_modes(dev);
1092
1093         ata_dump_id(dev->id);
1094
1095         /* ATA-specific feature tests */
1096         if (dev->class == ATA_DEV_ATA) {
1097                 dev->n_sectors = ata_id_n_sectors(dev->id);
1098
1099                 if (ata_id_has_lba(dev->id)) {
1100                         dev->flags |= ATA_DFLAG_LBA;
1101
1102                         if (ata_id_has_lba48(dev->id))
1103                                 dev->flags |= ATA_DFLAG_LBA48;
1104
1105                         /* print device info to dmesg */
1106                         printk(KERN_INFO "ata%u: dev %u ATA-%d, max %s, %Lu sectors:%s\n",
1107                                ap->id, device,
1108                                ata_id_major_version(dev->id),
1109                                ata_mode_string(xfer_modes),
1110                                (unsigned long long)dev->n_sectors,
1111                                dev->flags & ATA_DFLAG_LBA48 ? " LBA48" : " LBA");
1112                 } else { 
1113                         /* CHS */
1114
1115                         /* Default translation */
1116                         dev->cylinders  = dev->id[1];
1117                         dev->heads      = dev->id[3];
1118                         dev->sectors    = dev->id[6];
1119
1120                         if (ata_id_current_chs_valid(dev->id)) {
1121                                 /* Current CHS translation is valid. */
1122                                 dev->cylinders = dev->id[54];
1123                                 dev->heads     = dev->id[55];
1124                                 dev->sectors   = dev->id[56];
1125                         }
1126
1127                         /* print device info to dmesg */
1128                         printk(KERN_INFO "ata%u: dev %u ATA-%d, max %s, %Lu sectors: CHS %d/%d/%d\n",
1129                                ap->id, device,
1130                                ata_id_major_version(dev->id),
1131                                ata_mode_string(xfer_modes),
1132                                (unsigned long long)dev->n_sectors,
1133                                (int)dev->cylinders, (int)dev->heads, (int)dev->sectors);
1134
1135                 }
1136
1137                 if (dev->id[59] & 0x100) {
1138                         dev->multi_count = dev->id[59] & 0xff;
1139                         DPRINTK("ata%u: dev %u multi count %u\n",
1140                                 ap->id, device, dev->multi_count);
1141                 }
1142
1143         }
1144
1145         /* ATAPI-specific feature tests */
1146         else if (dev->class == ATA_DEV_ATAPI) {
1147                 rc = atapi_cdb_len(dev->id);
1148                 if ((rc < 12) || (rc > ATAPI_CDB_LEN)) {
1149                         printk(KERN_WARNING "ata%u: unsupported CDB len\n", ap->id);
1150                         goto err_out_nosup;
1151                 }
1152                 dev->cdb_len = (unsigned int) rc;
1153
1154                 if (ata_id_cdb_intr(dev->id))
1155                         dev->flags |= ATA_DFLAG_CDB_INTR;
1156
1157                 /* print device info to dmesg */
1158                 printk(KERN_INFO "ata%u: dev %u ATAPI, max %s\n",
1159                        ap->id, device,
1160                        ata_mode_string(xfer_modes));
1161         }
1162
1163         ap->host->max_cmd_len = 0;
1164         for (i = 0; i < ATA_MAX_DEVICES; i++)
1165                 ap->host->max_cmd_len = max_t(unsigned int,
1166                                               ap->host->max_cmd_len,
1167                                               ap->device[i].cdb_len);
1168
1169         DPRINTK("EXIT, drv_stat = 0x%x\n", ata_chk_status(ap));
1170         return;
1171
1172 err_out_nosup:
1173         printk(KERN_WARNING "ata%u: dev %u not supported, ignoring\n",
1174                ap->id, device);
1175 err_out:
1176         dev->class++;   /* converts ATA_DEV_xxx into ATA_DEV_xxx_UNSUP */
1177         DPRINTK("EXIT, err\n");
1178 }
1179
1180
1181 static inline u8 ata_dev_knobble(const struct ata_port *ap,
1182                                  struct ata_device *dev)
1183 {
1184         return ((ap->cbl == ATA_CBL_SATA) && (!ata_id_is_sata(dev->id)));
1185 }
1186
1187 /**
1188  * ata_dev_config - Run device specific handlers & check for SATA->PATA bridges
1189  * @ap: Bus
1190  * @i:  Device
1191  *
1192  * LOCKING:
1193  */
1194
1195 void ata_dev_config(struct ata_port *ap, unsigned int i)
1196 {
1197         /* limit bridge transfers to udma5, 200 sectors */
1198         if (ata_dev_knobble(ap, &ap->device[i])) {
1199                 printk(KERN_INFO "ata%u(%u): applying bridge limits\n",
1200                        ap->id, i);
1201                 ap->udma_mask &= ATA_UDMA5;
1202                 ap->device[i].max_sectors = ATA_MAX_SECTORS;
1203         }
1204
1205         if (ap->ops->dev_config)
1206                 ap->ops->dev_config(ap, &ap->device[i]);
1207 }
1208
1209 /**
1210  *      ata_bus_probe - Reset and probe ATA bus
1211  *      @ap: Bus to probe
1212  *
1213  *      Master ATA bus probing function.  Initiates a hardware-dependent
1214  *      bus reset, then attempts to identify any devices found on
1215  *      the bus.
1216  *
1217  *      LOCKING:
1218  *      PCI/etc. bus probe sem.
1219  *
1220  *      RETURNS:
1221  *      Zero on success, non-zero on error.
1222  */
1223
1224 static int ata_bus_probe(struct ata_port *ap)
1225 {
1226         unsigned int i, found = 0;
1227
1228         if (ap->ops->probe_reset) {
1229                 unsigned int classes[ATA_MAX_DEVICES];
1230                 int rc;
1231
1232                 ata_port_probe(ap);
1233
1234                 rc = ap->ops->probe_reset(ap, classes);
1235                 if (rc == 0) {
1236                         for (i = 0; i < ATA_MAX_DEVICES; i++) {
1237                                 if (classes[i] == ATA_DEV_UNKNOWN)
1238                                         classes[i] = ATA_DEV_NONE;
1239                                 ap->device[i].class = classes[i];
1240                         }
1241                 } else {
1242                         printk(KERN_ERR "ata%u: probe reset failed, "
1243                                "disabling port\n", ap->id);
1244                         ata_port_disable(ap);
1245                 }
1246         } else
1247                 ap->ops->phy_reset(ap);
1248
1249         if (ap->flags & ATA_FLAG_PORT_DISABLED)
1250                 goto err_out;
1251
1252         for (i = 0; i < ATA_MAX_DEVICES; i++) {
1253                 ata_dev_identify(ap, i);
1254                 if (ata_dev_present(&ap->device[i])) {
1255                         found = 1;
1256                         ata_dev_config(ap,i);
1257                 }
1258         }
1259
1260         if ((!found) || (ap->flags & ATA_FLAG_PORT_DISABLED))
1261                 goto err_out_disable;
1262
1263         ata_set_mode(ap);
1264         if (ap->flags & ATA_FLAG_PORT_DISABLED)
1265                 goto err_out_disable;
1266
1267         return 0;
1268
1269 err_out_disable:
1270         ap->ops->port_disable(ap);
1271 err_out:
1272         return -1;
1273 }
1274
1275 /**
1276  *      ata_port_probe - Mark port as enabled
1277  *      @ap: Port for which we indicate enablement
1278  *
1279  *      Modify @ap data structure such that the system
1280  *      thinks that the entire port is enabled.
1281  *
1282  *      LOCKING: host_set lock, or some other form of
1283  *      serialization.
1284  */
1285
1286 void ata_port_probe(struct ata_port *ap)
1287 {
1288         ap->flags &= ~ATA_FLAG_PORT_DISABLED;
1289 }
1290
1291 /**
1292  *      sata_print_link_status - Print SATA link status
1293  *      @ap: SATA port to printk link status about
1294  *
1295  *      This function prints link speed and status of a SATA link.
1296  *
1297  *      LOCKING:
1298  *      None.
1299  */
1300 static void sata_print_link_status(struct ata_port *ap)
1301 {
1302         u32 sstatus, tmp;
1303         const char *speed;
1304
1305         if (!ap->ops->scr_read)
1306                 return;
1307
1308         sstatus = scr_read(ap, SCR_STATUS);
1309
1310         if (sata_dev_present(ap)) {
1311                 tmp = (sstatus >> 4) & 0xf;
1312                 if (tmp & (1 << 0))
1313                         speed = "1.5";
1314                 else if (tmp & (1 << 1))
1315                         speed = "3.0";
1316                 else
1317                         speed = "<unknown>";
1318                 printk(KERN_INFO "ata%u: SATA link up %s Gbps (SStatus %X)\n",
1319                        ap->id, speed, sstatus);
1320         } else {
1321                 printk(KERN_INFO "ata%u: SATA link down (SStatus %X)\n",
1322                        ap->id, sstatus);
1323         }
1324 }
1325
1326 /**
1327  *      __sata_phy_reset - Wake/reset a low-level SATA PHY
1328  *      @ap: SATA port associated with target SATA PHY.
1329  *
1330  *      This function issues commands to standard SATA Sxxx
1331  *      PHY registers, to wake up the phy (and device), and
1332  *      clear any reset condition.
1333  *
1334  *      LOCKING:
1335  *      PCI/etc. bus probe sem.
1336  *
1337  */
1338 void __sata_phy_reset(struct ata_port *ap)
1339 {
1340         u32 sstatus;
1341         unsigned long timeout = jiffies + (HZ * 5);
1342
1343         if (ap->flags & ATA_FLAG_SATA_RESET) {
1344                 /* issue phy wake/reset */
1345                 scr_write_flush(ap, SCR_CONTROL, 0x301);
1346                 /* Couldn't find anything in SATA I/II specs, but
1347                  * AHCI-1.1 10.4.2 says at least 1 ms. */
1348                 mdelay(1);
1349         }
1350         scr_write_flush(ap, SCR_CONTROL, 0x300); /* phy wake/clear reset */
1351
1352         /* wait for phy to become ready, if necessary */
1353         do {
1354                 msleep(200);
1355                 sstatus = scr_read(ap, SCR_STATUS);
1356                 if ((sstatus & 0xf) != 1)
1357                         break;
1358         } while (time_before(jiffies, timeout));
1359
1360         /* print link status */
1361         sata_print_link_status(ap);
1362
1363         /* TODO: phy layer with polling, timeouts, etc. */
1364         if (sata_dev_present(ap))
1365                 ata_port_probe(ap);
1366         else
1367                 ata_port_disable(ap);
1368
1369         if (ap->flags & ATA_FLAG_PORT_DISABLED)
1370                 return;
1371
1372         if (ata_busy_sleep(ap, ATA_TMOUT_BOOT_QUICK, ATA_TMOUT_BOOT)) {
1373                 ata_port_disable(ap);
1374                 return;
1375         }
1376
1377         ap->cbl = ATA_CBL_SATA;
1378 }
1379
1380 /**
1381  *      sata_phy_reset - Reset SATA bus.
1382  *      @ap: SATA port associated with target SATA PHY.
1383  *
1384  *      This function resets the SATA bus, and then probes
1385  *      the bus for devices.
1386  *
1387  *      LOCKING:
1388  *      PCI/etc. bus probe sem.
1389  *
1390  */
1391 void sata_phy_reset(struct ata_port *ap)
1392 {
1393         __sata_phy_reset(ap);
1394         if (ap->flags & ATA_FLAG_PORT_DISABLED)
1395                 return;
1396         ata_bus_reset(ap);
1397 }
1398
1399 /**
1400  *      ata_port_disable - Disable port.
1401  *      @ap: Port to be disabled.
1402  *
1403  *      Modify @ap data structure such that the system
1404  *      thinks that the entire port is disabled, and should
1405  *      never attempt to probe or communicate with devices
1406  *      on this port.
1407  *
1408  *      LOCKING: host_set lock, or some other form of
1409  *      serialization.
1410  */
1411
1412 void ata_port_disable(struct ata_port *ap)
1413 {
1414         ap->device[0].class = ATA_DEV_NONE;
1415         ap->device[1].class = ATA_DEV_NONE;
1416         ap->flags |= ATA_FLAG_PORT_DISABLED;
1417 }
1418
1419 /*
1420  * This mode timing computation functionality is ported over from
1421  * drivers/ide/ide-timing.h and was originally written by Vojtech Pavlik
1422  */
1423 /*
1424  * PIO 0-5, MWDMA 0-2 and UDMA 0-6 timings (in nanoseconds).
1425  * These were taken from ATA/ATAPI-6 standard, rev 0a, except
1426  * for PIO 5, which is a nonstandard extension and UDMA6, which
1427  * is currently supported only by Maxtor drives. 
1428  */
1429
1430 static const struct ata_timing ata_timing[] = {
1431
1432         { XFER_UDMA_6,     0,   0,   0,   0,   0,   0,   0,  15 },
1433         { XFER_UDMA_5,     0,   0,   0,   0,   0,   0,   0,  20 },
1434         { XFER_UDMA_4,     0,   0,   0,   0,   0,   0,   0,  30 },
1435         { XFER_UDMA_3,     0,   0,   0,   0,   0,   0,   0,  45 },
1436
1437         { XFER_UDMA_2,     0,   0,   0,   0,   0,   0,   0,  60 },
1438         { XFER_UDMA_1,     0,   0,   0,   0,   0,   0,   0,  80 },
1439         { XFER_UDMA_0,     0,   0,   0,   0,   0,   0,   0, 120 },
1440
1441 /*      { XFER_UDMA_SLOW,  0,   0,   0,   0,   0,   0,   0, 150 }, */
1442                                           
1443         { XFER_MW_DMA_2,  25,   0,   0,   0,  70,  25, 120,   0 },
1444         { XFER_MW_DMA_1,  45,   0,   0,   0,  80,  50, 150,   0 },
1445         { XFER_MW_DMA_0,  60,   0,   0,   0, 215, 215, 480,   0 },
1446                                           
1447         { XFER_SW_DMA_2,  60,   0,   0,   0, 120, 120, 240,   0 },
1448         { XFER_SW_DMA_1,  90,   0,   0,   0, 240, 240, 480,   0 },
1449         { XFER_SW_DMA_0, 120,   0,   0,   0, 480, 480, 960,   0 },
1450
1451 /*      { XFER_PIO_5,     20,  50,  30, 100,  50,  30, 100,   0 }, */
1452         { XFER_PIO_4,     25,  70,  25, 120,  70,  25, 120,   0 },
1453         { XFER_PIO_3,     30,  80,  70, 180,  80,  70, 180,   0 },
1454
1455         { XFER_PIO_2,     30, 290,  40, 330, 100,  90, 240,   0 },
1456         { XFER_PIO_1,     50, 290,  93, 383, 125, 100, 383,   0 },
1457         { XFER_PIO_0,     70, 290, 240, 600, 165, 150, 600,   0 },
1458
1459 /*      { XFER_PIO_SLOW, 120, 290, 240, 960, 290, 240, 960,   0 }, */
1460
1461         { 0xFF }
1462 };
1463
1464 #define ENOUGH(v,unit)          (((v)-1)/(unit)+1)
1465 #define EZ(v,unit)              ((v)?ENOUGH(v,unit):0)
1466
1467 static void ata_timing_quantize(const struct ata_timing *t, struct ata_timing *q, int T, int UT)
1468 {
1469         q->setup   = EZ(t->setup   * 1000,  T);
1470         q->act8b   = EZ(t->act8b   * 1000,  T);
1471         q->rec8b   = EZ(t->rec8b   * 1000,  T);
1472         q->cyc8b   = EZ(t->cyc8b   * 1000,  T);
1473         q->active  = EZ(t->active  * 1000,  T);
1474         q->recover = EZ(t->recover * 1000,  T);
1475         q->cycle   = EZ(t->cycle   * 1000,  T);
1476         q->udma    = EZ(t->udma    * 1000, UT);
1477 }
1478
1479 void ata_timing_merge(const struct ata_timing *a, const struct ata_timing *b,
1480                       struct ata_timing *m, unsigned int what)
1481 {
1482         if (what & ATA_TIMING_SETUP  ) m->setup   = max(a->setup,   b->setup);
1483         if (what & ATA_TIMING_ACT8B  ) m->act8b   = max(a->act8b,   b->act8b);
1484         if (what & ATA_TIMING_REC8B  ) m->rec8b   = max(a->rec8b,   b->rec8b);
1485         if (what & ATA_TIMING_CYC8B  ) m->cyc8b   = max(a->cyc8b,   b->cyc8b);
1486         if (what & ATA_TIMING_ACTIVE ) m->active  = max(a->active,  b->active);
1487         if (what & ATA_TIMING_RECOVER) m->recover = max(a->recover, b->recover);
1488         if (what & ATA_TIMING_CYCLE  ) m->cycle   = max(a->cycle,   b->cycle);
1489         if (what & ATA_TIMING_UDMA   ) m->udma    = max(a->udma,    b->udma);
1490 }
1491
1492 static const struct ata_timing* ata_timing_find_mode(unsigned short speed)
1493 {
1494         const struct ata_timing *t;
1495
1496         for (t = ata_timing; t->mode != speed; t++)
1497                 if (t->mode == 0xFF)
1498                         return NULL;
1499         return t; 
1500 }
1501
1502 int ata_timing_compute(struct ata_device *adev, unsigned short speed,
1503                        struct ata_timing *t, int T, int UT)
1504 {
1505         const struct ata_timing *s;
1506         struct ata_timing p;
1507
1508         /*
1509          * Find the mode. 
1510          */
1511
1512         if (!(s = ata_timing_find_mode(speed)))
1513                 return -EINVAL;
1514
1515         memcpy(t, s, sizeof(*s));
1516
1517         /*
1518          * If the drive is an EIDE drive, it can tell us it needs extended
1519          * PIO/MW_DMA cycle timing.
1520          */
1521
1522         if (adev->id[ATA_ID_FIELD_VALID] & 2) { /* EIDE drive */
1523                 memset(&p, 0, sizeof(p));
1524                 if(speed >= XFER_PIO_0 && speed <= XFER_SW_DMA_0) {
1525                         if (speed <= XFER_PIO_2) p.cycle = p.cyc8b = adev->id[ATA_ID_EIDE_PIO];
1526                                             else p.cycle = p.cyc8b = adev->id[ATA_ID_EIDE_PIO_IORDY];
1527                 } else if(speed >= XFER_MW_DMA_0 && speed <= XFER_MW_DMA_2) {
1528                         p.cycle = adev->id[ATA_ID_EIDE_DMA_MIN];
1529                 }
1530                 ata_timing_merge(&p, t, t, ATA_TIMING_CYCLE | ATA_TIMING_CYC8B);
1531         }
1532
1533         /*
1534          * Convert the timing to bus clock counts.
1535          */
1536
1537         ata_timing_quantize(t, t, T, UT);
1538
1539         /*
1540          * Even in DMA/UDMA modes we still use PIO access for IDENTIFY,
1541          * S.M.A.R.T * and some other commands. We have to ensure that the
1542          * DMA cycle timing is slower/equal than the fastest PIO timing.
1543          */
1544
1545         if (speed > XFER_PIO_4) {
1546                 ata_timing_compute(adev, adev->pio_mode, &p, T, UT);
1547                 ata_timing_merge(&p, t, t, ATA_TIMING_ALL);
1548         }
1549
1550         /*
1551          * Lengthen active & recovery time so that cycle time is correct.
1552          */
1553
1554         if (t->act8b + t->rec8b < t->cyc8b) {
1555                 t->act8b += (t->cyc8b - (t->act8b + t->rec8b)) / 2;
1556                 t->rec8b = t->cyc8b - t->act8b;
1557         }
1558
1559         if (t->active + t->recover < t->cycle) {
1560                 t->active += (t->cycle - (t->active + t->recover)) / 2;
1561                 t->recover = t->cycle - t->active;
1562         }
1563
1564         return 0;
1565 }
1566
1567 static const struct {
1568         unsigned int shift;
1569         u8 base;
1570 } xfer_mode_classes[] = {
1571         { ATA_SHIFT_UDMA,       XFER_UDMA_0 },
1572         { ATA_SHIFT_MWDMA,      XFER_MW_DMA_0 },
1573         { ATA_SHIFT_PIO,        XFER_PIO_0 },
1574 };
1575
1576 static u8 base_from_shift(unsigned int shift)
1577 {
1578         int i;
1579
1580         for (i = 0; i < ARRAY_SIZE(xfer_mode_classes); i++)
1581                 if (xfer_mode_classes[i].shift == shift)
1582                         return xfer_mode_classes[i].base;
1583
1584         return 0xff;
1585 }
1586
1587 static void ata_dev_set_mode(struct ata_port *ap, struct ata_device *dev)
1588 {
1589         int ofs, idx;
1590         u8 base;
1591
1592         if (!ata_dev_present(dev) || (ap->flags & ATA_FLAG_PORT_DISABLED))
1593                 return;
1594
1595         if (dev->xfer_shift == ATA_SHIFT_PIO)
1596                 dev->flags |= ATA_DFLAG_PIO;
1597
1598         ata_dev_set_xfermode(ap, dev);
1599
1600         base = base_from_shift(dev->xfer_shift);
1601         ofs = dev->xfer_mode - base;
1602         idx = ofs + dev->xfer_shift;
1603         WARN_ON(idx >= ARRAY_SIZE(xfer_mode_str));
1604
1605         DPRINTK("idx=%d xfer_shift=%u, xfer_mode=0x%x, base=0x%x, offset=%d\n",
1606                 idx, dev->xfer_shift, (int)dev->xfer_mode, (int)base, ofs);
1607
1608         printk(KERN_INFO "ata%u: dev %u configured for %s\n",
1609                 ap->id, dev->devno, xfer_mode_str[idx]);
1610 }
1611
1612 static int ata_host_set_pio(struct ata_port *ap)
1613 {
1614         unsigned int mask;
1615         int x, i;
1616         u8 base, xfer_mode;
1617
1618         mask = ata_get_mode_mask(ap, ATA_SHIFT_PIO);
1619         x = fgb(mask);
1620         if (x < 0) {
1621                 printk(KERN_WARNING "ata%u: no PIO support\n", ap->id);
1622                 return -1;
1623         }
1624
1625         base = base_from_shift(ATA_SHIFT_PIO);
1626         xfer_mode = base + x;
1627
1628         DPRINTK("base 0x%x xfer_mode 0x%x mask 0x%x x %d\n",
1629                 (int)base, (int)xfer_mode, mask, x);
1630
1631         for (i = 0; i < ATA_MAX_DEVICES; i++) {
1632                 struct ata_device *dev = &ap->device[i];
1633                 if (ata_dev_present(dev)) {
1634                         dev->pio_mode = xfer_mode;
1635                         dev->xfer_mode = xfer_mode;
1636                         dev->xfer_shift = ATA_SHIFT_PIO;
1637                         if (ap->ops->set_piomode)
1638                                 ap->ops->set_piomode(ap, dev);
1639                 }
1640         }
1641
1642         return 0;
1643 }
1644
1645 static void ata_host_set_dma(struct ata_port *ap, u8 xfer_mode,
1646                             unsigned int xfer_shift)
1647 {
1648         int i;
1649
1650         for (i = 0; i < ATA_MAX_DEVICES; i++) {
1651                 struct ata_device *dev = &ap->device[i];
1652                 if (ata_dev_present(dev)) {
1653                         dev->dma_mode = xfer_mode;
1654                         dev->xfer_mode = xfer_mode;
1655                         dev->xfer_shift = xfer_shift;
1656                         if (ap->ops->set_dmamode)
1657                                 ap->ops->set_dmamode(ap, dev);
1658                 }
1659         }
1660 }
1661
1662 /**
1663  *      ata_set_mode - Program timings and issue SET FEATURES - XFER
1664  *      @ap: port on which timings will be programmed
1665  *
1666  *      Set ATA device disk transfer mode (PIO3, UDMA6, etc.).
1667  *
1668  *      LOCKING:
1669  *      PCI/etc. bus probe sem.
1670  */
1671 static void ata_set_mode(struct ata_port *ap)
1672 {
1673         unsigned int xfer_shift;
1674         u8 xfer_mode;
1675         int rc;
1676
1677         /* step 1: always set host PIO timings */
1678         rc = ata_host_set_pio(ap);
1679         if (rc)
1680                 goto err_out;
1681
1682         /* step 2: choose the best data xfer mode */
1683         xfer_mode = xfer_shift = 0;
1684         rc = ata_choose_xfer_mode(ap, &xfer_mode, &xfer_shift);
1685         if (rc)
1686                 goto err_out;
1687
1688         /* step 3: if that xfer mode isn't PIO, set host DMA timings */
1689         if (xfer_shift != ATA_SHIFT_PIO)
1690                 ata_host_set_dma(ap, xfer_mode, xfer_shift);
1691
1692         /* step 4: update devices' xfer mode */
1693         ata_dev_set_mode(ap, &ap->device[0]);
1694         ata_dev_set_mode(ap, &ap->device[1]);
1695
1696         if (ap->flags & ATA_FLAG_PORT_DISABLED)
1697                 return;
1698
1699         if (ap->ops->post_set_mode)
1700                 ap->ops->post_set_mode(ap);
1701
1702         return;
1703
1704 err_out:
1705         ata_port_disable(ap);
1706 }
1707
1708 /**
1709  *      ata_tf_to_host - issue ATA taskfile to host controller
1710  *      @ap: port to which command is being issued
1711  *      @tf: ATA taskfile register set
1712  *
1713  *      Issues ATA taskfile register set to ATA host controller,
1714  *      with proper synchronization with interrupt handler and
1715  *      other threads.
1716  *
1717  *      LOCKING:
1718  *      spin_lock_irqsave(host_set lock)
1719  */
1720
1721 static inline void ata_tf_to_host(struct ata_port *ap,
1722                                   const struct ata_taskfile *tf)
1723 {
1724         ap->ops->tf_load(ap, tf);
1725         ap->ops->exec_command(ap, tf);
1726 }
1727
1728 /**
1729  *      ata_busy_sleep - sleep until BSY clears, or timeout
1730  *      @ap: port containing status register to be polled
1731  *      @tmout_pat: impatience timeout
1732  *      @tmout: overall timeout
1733  *
1734  *      Sleep until ATA Status register bit BSY clears,
1735  *      or a timeout occurs.
1736  *
1737  *      LOCKING: None.
1738  */
1739
1740 unsigned int ata_busy_sleep (struct ata_port *ap,
1741                              unsigned long tmout_pat, unsigned long tmout)
1742 {
1743         unsigned long timer_start, timeout;
1744         u8 status;
1745
1746         status = ata_busy_wait(ap, ATA_BUSY, 300);
1747         timer_start = jiffies;
1748         timeout = timer_start + tmout_pat;
1749         while ((status & ATA_BUSY) && (time_before(jiffies, timeout))) {
1750                 msleep(50);
1751                 status = ata_busy_wait(ap, ATA_BUSY, 3);
1752         }
1753
1754         if (status & ATA_BUSY)
1755                 printk(KERN_WARNING "ata%u is slow to respond, "
1756                        "please be patient\n", ap->id);
1757
1758         timeout = timer_start + tmout;
1759         while ((status & ATA_BUSY) && (time_before(jiffies, timeout))) {
1760                 msleep(50);
1761                 status = ata_chk_status(ap);
1762         }
1763
1764         if (status & ATA_BUSY) {
1765                 printk(KERN_ERR "ata%u failed to respond (%lu secs)\n",
1766                        ap->id, tmout / HZ);
1767                 return 1;
1768         }
1769
1770         return 0;
1771 }
1772
1773 static void ata_bus_post_reset(struct ata_port *ap, unsigned int devmask)
1774 {
1775         struct ata_ioports *ioaddr = &ap->ioaddr;
1776         unsigned int dev0 = devmask & (1 << 0);
1777         unsigned int dev1 = devmask & (1 << 1);
1778         unsigned long timeout;
1779
1780         /* if device 0 was found in ata_devchk, wait for its
1781          * BSY bit to clear
1782          */
1783         if (dev0)
1784                 ata_busy_sleep(ap, ATA_TMOUT_BOOT_QUICK, ATA_TMOUT_BOOT);
1785
1786         /* if device 1 was found in ata_devchk, wait for
1787          * register access, then wait for BSY to clear
1788          */
1789         timeout = jiffies + ATA_TMOUT_BOOT;
1790         while (dev1) {
1791                 u8 nsect, lbal;
1792
1793                 ap->ops->dev_select(ap, 1);
1794                 if (ap->flags & ATA_FLAG_MMIO) {
1795                         nsect = readb((void __iomem *) ioaddr->nsect_addr);
1796                         lbal = readb((void __iomem *) ioaddr->lbal_addr);
1797                 } else {
1798                         nsect = inb(ioaddr->nsect_addr);
1799                         lbal = inb(ioaddr->lbal_addr);
1800                 }
1801                 if ((nsect == 1) && (lbal == 1))
1802                         break;
1803                 if (time_after(jiffies, timeout)) {
1804                         dev1 = 0;
1805                         break;
1806                 }
1807                 msleep(50);     /* give drive a breather */
1808         }
1809         if (dev1)
1810                 ata_busy_sleep(ap, ATA_TMOUT_BOOT_QUICK, ATA_TMOUT_BOOT);
1811
1812         /* is all this really necessary? */
1813         ap->ops->dev_select(ap, 0);
1814         if (dev1)
1815                 ap->ops->dev_select(ap, 1);
1816         if (dev0)
1817                 ap->ops->dev_select(ap, 0);
1818 }
1819
1820 /**
1821  *      ata_bus_edd - Issue EXECUTE DEVICE DIAGNOSTIC command.
1822  *      @ap: Port to reset and probe
1823  *
1824  *      Use the EXECUTE DEVICE DIAGNOSTIC command to reset and
1825  *      probe the bus.  Not often used these days.
1826  *
1827  *      LOCKING:
1828  *      PCI/etc. bus probe sem.
1829  *      Obtains host_set lock.
1830  *
1831  */
1832
1833 static unsigned int ata_bus_edd(struct ata_port *ap)
1834 {
1835         struct ata_taskfile tf;
1836         unsigned long flags;
1837
1838         /* set up execute-device-diag (bus reset) taskfile */
1839         /* also, take interrupts to a known state (disabled) */
1840         DPRINTK("execute-device-diag\n");
1841         ata_tf_init(ap, &tf, 0);
1842         tf.ctl |= ATA_NIEN;
1843         tf.command = ATA_CMD_EDD;
1844         tf.protocol = ATA_PROT_NODATA;
1845
1846         /* do bus reset */
1847         spin_lock_irqsave(&ap->host_set->lock, flags);
1848         ata_tf_to_host(ap, &tf);
1849         spin_unlock_irqrestore(&ap->host_set->lock, flags);
1850
1851         /* spec says at least 2ms.  but who knows with those
1852          * crazy ATAPI devices...
1853          */
1854         msleep(150);
1855
1856         return ata_busy_sleep(ap, ATA_TMOUT_BOOT_QUICK, ATA_TMOUT_BOOT);
1857 }
1858
1859 static unsigned int ata_bus_softreset(struct ata_port *ap,
1860                                       unsigned int devmask)
1861 {
1862         struct ata_ioports *ioaddr = &ap->ioaddr;
1863
1864         DPRINTK("ata%u: bus reset via SRST\n", ap->id);
1865
1866         /* software reset.  causes dev0 to be selected */
1867         if (ap->flags & ATA_FLAG_MMIO) {
1868                 writeb(ap->ctl, (void __iomem *) ioaddr->ctl_addr);
1869                 udelay(20);     /* FIXME: flush */
1870                 writeb(ap->ctl | ATA_SRST, (void __iomem *) ioaddr->ctl_addr);
1871                 udelay(20);     /* FIXME: flush */
1872                 writeb(ap->ctl, (void __iomem *) ioaddr->ctl_addr);
1873         } else {
1874                 outb(ap->ctl, ioaddr->ctl_addr);
1875                 udelay(10);
1876                 outb(ap->ctl | ATA_SRST, ioaddr->ctl_addr);
1877                 udelay(10);
1878                 outb(ap->ctl, ioaddr->ctl_addr);
1879         }
1880
1881         /* spec mandates ">= 2ms" before checking status.
1882          * We wait 150ms, because that was the magic delay used for
1883          * ATAPI devices in Hale Landis's ATADRVR, for the period of time
1884          * between when the ATA command register is written, and then
1885          * status is checked.  Because waiting for "a while" before
1886          * checking status is fine, post SRST, we perform this magic
1887          * delay here as well.
1888          */
1889         msleep(150);
1890
1891         ata_bus_post_reset(ap, devmask);
1892
1893         return 0;
1894 }
1895
1896 /**
1897  *      ata_bus_reset - reset host port and associated ATA channel
1898  *      @ap: port to reset
1899  *
1900  *      This is typically the first time we actually start issuing
1901  *      commands to the ATA channel.  We wait for BSY to clear, then
1902  *      issue EXECUTE DEVICE DIAGNOSTIC command, polling for its
1903  *      result.  Determine what devices, if any, are on the channel
1904  *      by looking at the device 0/1 error register.  Look at the signature
1905  *      stored in each device's taskfile registers, to determine if
1906  *      the device is ATA or ATAPI.
1907  *
1908  *      LOCKING:
1909  *      PCI/etc. bus probe sem.
1910  *      Obtains host_set lock.
1911  *
1912  *      SIDE EFFECTS:
1913  *      Sets ATA_FLAG_PORT_DISABLED if bus reset fails.
1914  */
1915
1916 void ata_bus_reset(struct ata_port *ap)
1917 {
1918         struct ata_ioports *ioaddr = &ap->ioaddr;
1919         unsigned int slave_possible = ap->flags & ATA_FLAG_SLAVE_POSS;
1920         u8 err;
1921         unsigned int dev0, dev1 = 0, rc = 0, devmask = 0;
1922
1923         DPRINTK("ENTER, host %u, port %u\n", ap->id, ap->port_no);
1924
1925         /* determine if device 0/1 are present */
1926         if (ap->flags & ATA_FLAG_SATA_RESET)
1927                 dev0 = 1;
1928         else {
1929                 dev0 = ata_devchk(ap, 0);
1930                 if (slave_possible)
1931                         dev1 = ata_devchk(ap, 1);
1932         }
1933
1934         if (dev0)
1935                 devmask |= (1 << 0);
1936         if (dev1)
1937                 devmask |= (1 << 1);
1938
1939         /* select device 0 again */
1940         ap->ops->dev_select(ap, 0);
1941
1942         /* issue bus reset */
1943         if (ap->flags & ATA_FLAG_SRST)
1944                 rc = ata_bus_softreset(ap, devmask);
1945         else if ((ap->flags & ATA_FLAG_SATA_RESET) == 0) {
1946                 /* set up device control */
1947                 if (ap->flags & ATA_FLAG_MMIO)
1948                         writeb(ap->ctl, (void __iomem *) ioaddr->ctl_addr);
1949                 else
1950                         outb(ap->ctl, ioaddr->ctl_addr);
1951                 rc = ata_bus_edd(ap);
1952         }
1953
1954         if (rc)
1955                 goto err_out;
1956
1957         /*
1958          * determine by signature whether we have ATA or ATAPI devices
1959          */
1960         ap->device[0].class = ata_dev_try_classify(ap, 0, &err);
1961         if ((slave_possible) && (err != 0x81))
1962                 ap->device[1].class = ata_dev_try_classify(ap, 1, &err);
1963
1964         /* re-enable interrupts */
1965         if (ap->ioaddr.ctl_addr)        /* FIXME: hack. create a hook instead */
1966                 ata_irq_on(ap);
1967
1968         /* is double-select really necessary? */
1969         if (ap->device[1].class != ATA_DEV_NONE)
1970                 ap->ops->dev_select(ap, 1);
1971         if (ap->device[0].class != ATA_DEV_NONE)
1972                 ap->ops->dev_select(ap, 0);
1973
1974         /* if no devices were detected, disable this port */
1975         if ((ap->device[0].class == ATA_DEV_NONE) &&
1976             (ap->device[1].class == ATA_DEV_NONE))
1977                 goto err_out;
1978
1979         if (ap->flags & (ATA_FLAG_SATA_RESET | ATA_FLAG_SRST)) {
1980                 /* set up device control for ATA_FLAG_SATA_RESET */
1981                 if (ap->flags & ATA_FLAG_MMIO)
1982                         writeb(ap->ctl, (void __iomem *) ioaddr->ctl_addr);
1983                 else
1984                         outb(ap->ctl, ioaddr->ctl_addr);
1985         }
1986
1987         DPRINTK("EXIT\n");
1988         return;
1989
1990 err_out:
1991         printk(KERN_ERR "ata%u: disabling port\n", ap->id);
1992         ap->ops->port_disable(ap);
1993
1994         DPRINTK("EXIT\n");
1995 }
1996
1997 static int sata_phy_resume(struct ata_port *ap)
1998 {
1999         unsigned long timeout = jiffies + (HZ * 5);
2000         u32 sstatus;
2001
2002         scr_write_flush(ap, SCR_CONTROL, 0x300);
2003
2004         /* Wait for phy to become ready, if necessary. */
2005         do {
2006                 msleep(200);
2007                 sstatus = scr_read(ap, SCR_STATUS);
2008                 if ((sstatus & 0xf) != 1)
2009                         return 0;
2010         } while (time_before(jiffies, timeout));
2011
2012         return -1;
2013 }
2014
2015 /**
2016  *      ata_std_probeinit - initialize probing
2017  *      @ap: port to be probed
2018  *
2019  *      @ap is about to be probed.  Initialize it.  This function is
2020  *      to be used as standard callback for ata_drive_probe_reset().
2021  *
2022  *      NOTE!!! Do not use this function as probeinit if a low level
2023  *      driver implements only hardreset.  Just pass NULL as probeinit
2024  *      in that case.  Using this function is probably okay but doing
2025  *      so makes reset sequence different from the original
2026  *      ->phy_reset implementation and Jeff nervous.  :-P
2027  */
2028 extern void ata_std_probeinit(struct ata_port *ap)
2029 {
2030         if (ap->flags & ATA_FLAG_SATA && ap->ops->scr_read) {
2031                 sata_phy_resume(ap);
2032                 if (sata_dev_present(ap))
2033                         ata_busy_sleep(ap, ATA_TMOUT_BOOT_QUICK, ATA_TMOUT_BOOT);
2034         }
2035 }
2036
2037 /**
2038  *      ata_std_softreset - reset host port via ATA SRST
2039  *      @ap: port to reset
2040  *      @verbose: fail verbosely
2041  *      @classes: resulting classes of attached devices
2042  *
2043  *      Reset host port using ATA SRST.  This function is to be used
2044  *      as standard callback for ata_drive_*_reset() functions.
2045  *
2046  *      LOCKING:
2047  *      Kernel thread context (may sleep)
2048  *
2049  *      RETURNS:
2050  *      0 on success, -errno otherwise.
2051  */
2052 int ata_std_softreset(struct ata_port *ap, int verbose, unsigned int *classes)
2053 {
2054         unsigned int slave_possible = ap->flags & ATA_FLAG_SLAVE_POSS;
2055         unsigned int devmask = 0, err_mask;
2056         u8 err;
2057
2058         DPRINTK("ENTER\n");
2059
2060         if (ap->ops->scr_read && !sata_dev_present(ap)) {
2061                 classes[0] = ATA_DEV_NONE;
2062                 goto out;
2063         }
2064
2065         /* determine if device 0/1 are present */
2066         if (ata_devchk(ap, 0))
2067                 devmask |= (1 << 0);
2068         if (slave_possible && ata_devchk(ap, 1))
2069                 devmask |= (1 << 1);
2070
2071         /* select device 0 again */
2072         ap->ops->dev_select(ap, 0);
2073
2074         /* issue bus reset */
2075         DPRINTK("about to softreset, devmask=%x\n", devmask);
2076         err_mask = ata_bus_softreset(ap, devmask);
2077         if (err_mask) {
2078                 if (verbose)
2079                         printk(KERN_ERR "ata%u: SRST failed (err_mask=0x%x)\n",
2080                                ap->id, err_mask);
2081                 else
2082                         DPRINTK("EXIT, softreset failed (err_mask=0x%x)\n",
2083                                 err_mask);
2084                 return -EIO;
2085         }
2086
2087         /* determine by signature whether we have ATA or ATAPI devices */
2088         classes[0] = ata_dev_try_classify(ap, 0, &err);
2089         if (slave_possible && err != 0x81)
2090                 classes[1] = ata_dev_try_classify(ap, 1, &err);
2091
2092  out:
2093         DPRINTK("EXIT, classes[0]=%u [1]=%u\n", classes[0], classes[1]);
2094         return 0;
2095 }
2096
2097 /**
2098  *      sata_std_hardreset - reset host port via SATA phy reset
2099  *      @ap: port to reset
2100  *      @verbose: fail verbosely
2101  *      @class: resulting class of attached device
2102  *
2103  *      SATA phy-reset host port using DET bits of SControl register.
2104  *      This function is to be used as standard callback for
2105  *      ata_drive_*_reset().
2106  *
2107  *      LOCKING:
2108  *      Kernel thread context (may sleep)
2109  *
2110  *      RETURNS:
2111  *      0 on success, -errno otherwise.
2112  */
2113 int sata_std_hardreset(struct ata_port *ap, int verbose, unsigned int *class)
2114 {
2115         DPRINTK("ENTER\n");
2116
2117         /* Issue phy wake/reset */
2118         scr_write_flush(ap, SCR_CONTROL, 0x301);
2119
2120         /*
2121          * Couldn't find anything in SATA I/II specs, but AHCI-1.1
2122          * 10.4.2 says at least 1 ms.
2123          */
2124         msleep(1);
2125
2126         /* Bring phy back */
2127         sata_phy_resume(ap);
2128
2129         /* TODO: phy layer with polling, timeouts, etc. */
2130         if (!sata_dev_present(ap)) {
2131                 *class = ATA_DEV_NONE;
2132                 DPRINTK("EXIT, link offline\n");
2133                 return 0;
2134         }
2135
2136         if (ata_busy_sleep(ap, ATA_TMOUT_BOOT_QUICK, ATA_TMOUT_BOOT)) {
2137                 if (verbose)
2138                         printk(KERN_ERR "ata%u: COMRESET failed "
2139                                "(device not ready)\n", ap->id);
2140                 else
2141                         DPRINTK("EXIT, device not ready\n");
2142                 return -EIO;
2143         }
2144
2145         ap->ops->dev_select(ap, 0);     /* probably unnecessary */
2146
2147         *class = ata_dev_try_classify(ap, 0, NULL);
2148
2149         DPRINTK("EXIT, class=%u\n", *class);
2150         return 0;
2151 }
2152
2153 /**
2154  *      ata_std_postreset - standard postreset callback
2155  *      @ap: the target ata_port
2156  *      @classes: classes of attached devices
2157  *
2158  *      This function is invoked after a successful reset.  Note that
2159  *      the device might have been reset more than once using
2160  *      different reset methods before postreset is invoked.
2161  *
2162  *      This function is to be used as standard callback for
2163  *      ata_drive_*_reset().
2164  *
2165  *      LOCKING:
2166  *      Kernel thread context (may sleep)
2167  */
2168 void ata_std_postreset(struct ata_port *ap, unsigned int *classes)
2169 {
2170         DPRINTK("ENTER\n");
2171
2172         /* set cable type if it isn't already set */
2173         if (ap->cbl == ATA_CBL_NONE && ap->flags & ATA_FLAG_SATA)
2174                 ap->cbl = ATA_CBL_SATA;
2175
2176         /* print link status */
2177         if (ap->cbl == ATA_CBL_SATA)
2178                 sata_print_link_status(ap);
2179
2180         /* re-enable interrupts */
2181         if (ap->ioaddr.ctl_addr)        /* FIXME: hack. create a hook instead */
2182                 ata_irq_on(ap);
2183
2184         /* is double-select really necessary? */
2185         if (classes[0] != ATA_DEV_NONE)
2186                 ap->ops->dev_select(ap, 1);
2187         if (classes[1] != ATA_DEV_NONE)
2188                 ap->ops->dev_select(ap, 0);
2189
2190         /* bail out if no device is present */
2191         if (classes[0] == ATA_DEV_NONE && classes[1] == ATA_DEV_NONE) {
2192                 DPRINTK("EXIT, no device\n");
2193                 return;
2194         }
2195
2196         /* set up device control */
2197         if (ap->ioaddr.ctl_addr) {
2198                 if (ap->flags & ATA_FLAG_MMIO)
2199                         writeb(ap->ctl, (void __iomem *) ap->ioaddr.ctl_addr);
2200                 else
2201                         outb(ap->ctl, ap->ioaddr.ctl_addr);
2202         }
2203
2204         DPRINTK("EXIT\n");
2205 }
2206
2207 /**
2208  *      ata_std_probe_reset - standard probe reset method
2209  *      @ap: prot to perform probe-reset
2210  *      @classes: resulting classes of attached devices
2211  *
2212  *      The stock off-the-shelf ->probe_reset method.
2213  *
2214  *      LOCKING:
2215  *      Kernel thread context (may sleep)
2216  *
2217  *      RETURNS:
2218  *      0 on success, -errno otherwise.
2219  */
2220 int ata_std_probe_reset(struct ata_port *ap, unsigned int *classes)
2221 {
2222         ata_reset_fn_t hardreset;
2223
2224         hardreset = NULL;
2225         if (ap->flags & ATA_FLAG_SATA && ap->ops->scr_read)
2226                 hardreset = sata_std_hardreset;
2227
2228         return ata_drive_probe_reset(ap, ata_std_probeinit,
2229                                      ata_std_softreset, hardreset,
2230                                      ata_std_postreset, classes);
2231 }
2232
2233 static int do_probe_reset(struct ata_port *ap, ata_reset_fn_t reset,
2234                           ata_postreset_fn_t postreset,
2235                           unsigned int *classes)
2236 {
2237         int i, rc;
2238
2239         for (i = 0; i < ATA_MAX_DEVICES; i++)
2240                 classes[i] = ATA_DEV_UNKNOWN;
2241
2242         rc = reset(ap, 0, classes);
2243         if (rc)
2244                 return rc;
2245
2246         /* If any class isn't ATA_DEV_UNKNOWN, consider classification
2247          * is complete and convert all ATA_DEV_UNKNOWN to
2248          * ATA_DEV_NONE.
2249          */
2250         for (i = 0; i < ATA_MAX_DEVICES; i++)
2251                 if (classes[i] != ATA_DEV_UNKNOWN)
2252                         break;
2253
2254         if (i < ATA_MAX_DEVICES)
2255                 for (i = 0; i < ATA_MAX_DEVICES; i++)
2256                         if (classes[i] == ATA_DEV_UNKNOWN)
2257                                 classes[i] = ATA_DEV_NONE;
2258
2259         if (postreset)
2260                 postreset(ap, classes);
2261
2262         return classes[0] != ATA_DEV_UNKNOWN ? 0 : -ENODEV;
2263 }
2264
2265 /**
2266  *      ata_drive_probe_reset - Perform probe reset with given methods
2267  *      @ap: port to reset
2268  *      @probeinit: probeinit method (can be NULL)
2269  *      @softreset: softreset method (can be NULL)
2270  *      @hardreset: hardreset method (can be NULL)
2271  *      @postreset: postreset method (can be NULL)
2272  *      @classes: resulting classes of attached devices
2273  *
2274  *      Reset the specified port and classify attached devices using
2275  *      given methods.  This function prefers softreset but tries all
2276  *      possible reset sequences to reset and classify devices.  This
2277  *      function is intended to be used for constructing ->probe_reset
2278  *      callback by low level drivers.
2279  *
2280  *      Reset methods should follow the following rules.
2281  *
2282  *      - Return 0 on sucess, -errno on failure.
2283  *      - If classification is supported, fill classes[] with
2284  *        recognized class codes.
2285  *      - If classification is not supported, leave classes[] alone.
2286  *      - If verbose is non-zero, print error message on failure;
2287  *        otherwise, shut up.
2288  *
2289  *      LOCKING:
2290  *      Kernel thread context (may sleep)
2291  *
2292  *      RETURNS:
2293  *      0 on success, -EINVAL if no reset method is avaliable, -ENODEV
2294  *      if classification fails, and any error code from reset
2295  *      methods.
2296  */
2297 int ata_drive_probe_reset(struct ata_port *ap, ata_probeinit_fn_t probeinit,
2298                           ata_reset_fn_t softreset, ata_reset_fn_t hardreset,
2299                           ata_postreset_fn_t postreset, unsigned int *classes)
2300 {
2301         int rc = -EINVAL;
2302
2303         if (probeinit)
2304                 probeinit(ap);
2305
2306         if (softreset) {
2307                 rc = do_probe_reset(ap, softreset, postreset, classes);
2308                 if (rc == 0)
2309                         return 0;
2310         }
2311
2312         if (!hardreset)
2313                 return rc;
2314
2315         rc = do_probe_reset(ap, hardreset, postreset, classes);
2316         if (rc == 0 || rc != -ENODEV)
2317                 return rc;
2318
2319         if (softreset)
2320                 rc = do_probe_reset(ap, softreset, postreset, classes);
2321
2322         return rc;
2323 }
2324
2325 static void ata_pr_blacklisted(const struct ata_port *ap,
2326                                const struct ata_device *dev)
2327 {
2328         printk(KERN_WARNING "ata%u: dev %u is on DMA blacklist, disabling DMA\n",
2329                 ap->id, dev->devno);
2330 }
2331
2332 static const char * const ata_dma_blacklist [] = {
2333         "WDC AC11000H",
2334         "WDC AC22100H",
2335         "WDC AC32500H",
2336         "WDC AC33100H",
2337         "WDC AC31600H",
2338         "WDC AC32100H",
2339         "WDC AC23200L",
2340         "Compaq CRD-8241B",
2341         "CRD-8400B",
2342         "CRD-8480B",
2343         "CRD-8482B",
2344         "CRD-84",
2345         "SanDisk SDP3B",
2346         "SanDisk SDP3B-64",
2347         "SANYO CD-ROM CRD",
2348         "HITACHI CDR-8",
2349         "HITACHI CDR-8335",
2350         "HITACHI CDR-8435",
2351         "Toshiba CD-ROM XM-6202B",
2352         "TOSHIBA CD-ROM XM-1702BC",
2353         "CD-532E-A",
2354         "E-IDE CD-ROM CR-840",
2355         "CD-ROM Drive/F5A",
2356         "WPI CDD-820",
2357         "SAMSUNG CD-ROM SC-148C",
2358         "SAMSUNG CD-ROM SC",
2359         "SanDisk SDP3B-64",
2360         "ATAPI CD-ROM DRIVE 40X MAXIMUM",
2361         "_NEC DV5800A",
2362 };
2363
2364 static int ata_dma_blacklisted(const struct ata_device *dev)
2365 {
2366         unsigned char model_num[41];
2367         int i;
2368
2369         ata_id_c_string(dev->id, model_num, ATA_ID_PROD_OFS, sizeof(model_num));
2370
2371         for (i = 0; i < ARRAY_SIZE(ata_dma_blacklist); i++)
2372                 if (!strcmp(ata_dma_blacklist[i], model_num))
2373                         return 1;
2374
2375         return 0;
2376 }
2377
2378 static unsigned int ata_get_mode_mask(const struct ata_port *ap, int shift)
2379 {
2380         const struct ata_device *master, *slave;
2381         unsigned int mask;
2382
2383         master = &ap->device[0];
2384         slave = &ap->device[1];
2385
2386         WARN_ON(!ata_dev_present(master) && !ata_dev_present(slave));
2387
2388         if (shift == ATA_SHIFT_UDMA) {
2389                 mask = ap->udma_mask;
2390                 if (ata_dev_present(master)) {
2391                         mask &= (master->id[ATA_ID_UDMA_MODES] & 0xff);
2392                         if (ata_dma_blacklisted(master)) {
2393                                 mask = 0;
2394                                 ata_pr_blacklisted(ap, master);
2395                         }
2396                 }
2397                 if (ata_dev_present(slave)) {
2398                         mask &= (slave->id[ATA_ID_UDMA_MODES] & 0xff);
2399                         if (ata_dma_blacklisted(slave)) {
2400                                 mask = 0;
2401                                 ata_pr_blacklisted(ap, slave);
2402                         }
2403                 }
2404         }
2405         else if (shift == ATA_SHIFT_MWDMA) {
2406                 mask = ap->mwdma_mask;
2407                 if (ata_dev_present(master)) {
2408                         mask &= (master->id[ATA_ID_MWDMA_MODES] & 0x07);
2409                         if (ata_dma_blacklisted(master)) {
2410                                 mask = 0;
2411                                 ata_pr_blacklisted(ap, master);
2412                         }
2413                 }
2414                 if (ata_dev_present(slave)) {
2415                         mask &= (slave->id[ATA_ID_MWDMA_MODES] & 0x07);
2416                         if (ata_dma_blacklisted(slave)) {
2417                                 mask = 0;
2418                                 ata_pr_blacklisted(ap, slave);
2419                         }
2420                 }
2421         }
2422         else if (shift == ATA_SHIFT_PIO) {
2423                 mask = ap->pio_mask;
2424                 if (ata_dev_present(master)) {
2425                         /* spec doesn't return explicit support for
2426                          * PIO0-2, so we fake it
2427                          */
2428                         u16 tmp_mode = master->id[ATA_ID_PIO_MODES] & 0x03;
2429                         tmp_mode <<= 3;
2430                         tmp_mode |= 0x7;
2431                         mask &= tmp_mode;
2432                 }
2433                 if (ata_dev_present(slave)) {
2434                         /* spec doesn't return explicit support for
2435                          * PIO0-2, so we fake it
2436                          */
2437                         u16 tmp_mode = slave->id[ATA_ID_PIO_MODES] & 0x03;
2438                         tmp_mode <<= 3;
2439                         tmp_mode |= 0x7;
2440                         mask &= tmp_mode;
2441                 }
2442         }
2443         else {
2444                 mask = 0xffffffff; /* shut up compiler warning */
2445                 BUG();
2446         }
2447
2448         return mask;
2449 }
2450
2451 /* find greatest bit */
2452 static int fgb(u32 bitmap)
2453 {
2454         unsigned int i;
2455         int x = -1;
2456
2457         for (i = 0; i < 32; i++)
2458                 if (bitmap & (1 << i))
2459                         x = i;
2460
2461         return x;
2462 }
2463
2464 /**
2465  *      ata_choose_xfer_mode - attempt to find best transfer mode
2466  *      @ap: Port for which an xfer mode will be selected
2467  *      @xfer_mode_out: (output) SET FEATURES - XFER MODE code
2468  *      @xfer_shift_out: (output) bit shift that selects this mode
2469  *
2470  *      Based on host and device capabilities, determine the
2471  *      maximum transfer mode that is amenable to all.
2472  *
2473  *      LOCKING:
2474  *      PCI/etc. bus probe sem.
2475  *
2476  *      RETURNS:
2477  *      Zero on success, negative on error.
2478  */
2479
2480 static int ata_choose_xfer_mode(const struct ata_port *ap,
2481                                 u8 *xfer_mode_out,
2482                                 unsigned int *xfer_shift_out)
2483 {
2484         unsigned int mask, shift;
2485         int x, i;
2486
2487         for (i = 0; i < ARRAY_SIZE(xfer_mode_classes); i++) {
2488                 shift = xfer_mode_classes[i].shift;
2489                 mask = ata_get_mode_mask(ap, shift);
2490
2491                 x = fgb(mask);
2492                 if (x >= 0) {
2493                         *xfer_mode_out = xfer_mode_classes[i].base + x;
2494                         *xfer_shift_out = shift;
2495                         return 0;
2496                 }
2497         }
2498
2499         return -1;
2500 }
2501
2502 /**
2503  *      ata_dev_set_xfermode - Issue SET FEATURES - XFER MODE command
2504  *      @ap: Port associated with device @dev
2505  *      @dev: Device to which command will be sent
2506  *
2507  *      Issue SET FEATURES - XFER MODE command to device @dev
2508  *      on port @ap.
2509  *
2510  *      LOCKING:
2511  *      PCI/etc. bus probe sem.
2512  */
2513
2514 static void ata_dev_set_xfermode(struct ata_port *ap, struct ata_device *dev)
2515 {
2516         struct ata_taskfile tf;
2517
2518         /* set up set-features taskfile */
2519         DPRINTK("set features - xfer mode\n");
2520
2521         ata_tf_init(ap, &tf, dev->devno);
2522         tf.command = ATA_CMD_SET_FEATURES;
2523         tf.feature = SETFEATURES_XFER;
2524         tf.flags |= ATA_TFLAG_ISADDR | ATA_TFLAG_DEVICE;
2525         tf.protocol = ATA_PROT_NODATA;
2526         tf.nsect = dev->xfer_mode;
2527
2528         if (ata_exec_internal(ap, dev, &tf, DMA_NONE, NULL, 0)) {
2529                 printk(KERN_ERR "ata%u: failed to set xfermode, disabled\n",
2530                        ap->id);
2531                 ata_port_disable(ap);
2532         }
2533
2534         DPRINTK("EXIT\n");
2535 }
2536
2537 /**
2538  *      ata_dev_init_params - Issue INIT DEV PARAMS command
2539  *      @ap: Port associated with device @dev
2540  *      @dev: Device to which command will be sent
2541  *
2542  *      LOCKING:
2543  *      Kernel thread context (may sleep)
2544  *
2545  *      RETURNS:
2546  *      0 on success, AC_ERR_* mask otherwise.
2547  */
2548
2549 static unsigned int ata_dev_init_params(struct ata_port *ap,
2550                                         struct ata_device *dev)
2551 {
2552         struct ata_taskfile tf;
2553         unsigned int err_mask;
2554         u16 sectors = dev->id[6];
2555         u16 heads   = dev->id[3];
2556
2557         /* Number of sectors per track 1-255. Number of heads 1-16 */
2558         if (sectors < 1 || sectors > 255 || heads < 1 || heads > 16)
2559                 return 0;
2560
2561         /* set up init dev params taskfile */
2562         DPRINTK("init dev params \n");
2563
2564         ata_tf_init(ap, &tf, dev->devno);
2565         tf.command = ATA_CMD_INIT_DEV_PARAMS;
2566         tf.flags |= ATA_TFLAG_ISADDR | ATA_TFLAG_DEVICE;
2567         tf.protocol = ATA_PROT_NODATA;
2568         tf.nsect = sectors;
2569         tf.device |= (heads - 1) & 0x0f; /* max head = num. of heads - 1 */
2570
2571         err_mask = ata_exec_internal(ap, dev, &tf, DMA_NONE, NULL, 0);
2572
2573         DPRINTK("EXIT, err_mask=%x\n", err_mask);
2574         return err_mask;
2575 }
2576
2577 /**
2578  *      ata_sg_clean - Unmap DMA memory associated with command
2579  *      @qc: Command containing DMA memory to be released
2580  *
2581  *      Unmap all mapped DMA memory associated with this command.
2582  *
2583  *      LOCKING:
2584  *      spin_lock_irqsave(host_set lock)
2585  */
2586
2587 static void ata_sg_clean(struct ata_queued_cmd *qc)
2588 {
2589         struct ata_port *ap = qc->ap;
2590         struct scatterlist *sg = qc->__sg;
2591         int dir = qc->dma_dir;
2592         void *pad_buf = NULL;
2593
2594         WARN_ON(!(qc->flags & ATA_QCFLAG_DMAMAP));
2595         WARN_ON(sg == NULL);
2596
2597         if (qc->flags & ATA_QCFLAG_SINGLE)
2598                 WARN_ON(qc->n_elem > 1);
2599
2600         VPRINTK("unmapping %u sg elements\n", qc->n_elem);
2601
2602         /* if we padded the buffer out to 32-bit bound, and data
2603          * xfer direction is from-device, we must copy from the
2604          * pad buffer back into the supplied buffer
2605          */
2606         if (qc->pad_len && !(qc->tf.flags & ATA_TFLAG_WRITE))
2607                 pad_buf = ap->pad + (qc->tag * ATA_DMA_PAD_SZ);
2608
2609         if (qc->flags & ATA_QCFLAG_SG) {
2610                 if (qc->n_elem)
2611                         dma_unmap_sg(ap->host_set->dev, sg, qc->n_elem, dir);
2612                 /* restore last sg */
2613                 sg[qc->orig_n_elem - 1].length += qc->pad_len;
2614                 if (pad_buf) {
2615                         struct scatterlist *psg = &qc->pad_sgent;
2616                         void *addr = kmap_atomic(psg->page, KM_IRQ0);
2617                         memcpy(addr + psg->offset, pad_buf, qc->pad_len);
2618                         kunmap_atomic(addr, KM_IRQ0);
2619                 }
2620         } else {
2621                 if (qc->n_elem)
2622                         dma_unmap_single(ap->host_set->dev,
2623                                 sg_dma_address(&sg[0]), sg_dma_len(&sg[0]),
2624                                 dir);
2625                 /* restore sg */
2626                 sg->length += qc->pad_len;
2627                 if (pad_buf)
2628                         memcpy(qc->buf_virt + sg->length - qc->pad_len,
2629                                pad_buf, qc->pad_len);
2630         }
2631
2632         qc->flags &= ~ATA_QCFLAG_DMAMAP;
2633         qc->__sg = NULL;
2634 }
2635
2636 /**
2637  *      ata_fill_sg - Fill PCI IDE PRD table
2638  *      @qc: Metadata associated with taskfile to be transferred
2639  *
2640  *      Fill PCI IDE PRD (scatter-gather) table with segments
2641  *      associated with the current disk command.
2642  *
2643  *      LOCKING:
2644  *      spin_lock_irqsave(host_set lock)
2645  *
2646  */
2647 static void ata_fill_sg(struct ata_queued_cmd *qc)
2648 {
2649         struct ata_port *ap = qc->ap;
2650         struct scatterlist *sg;
2651         unsigned int idx;
2652
2653         WARN_ON(qc->__sg == NULL);
2654         WARN_ON(qc->n_elem == 0 && qc->pad_len == 0);
2655
2656         idx = 0;
2657         ata_for_each_sg(sg, qc) {
2658                 u32 addr, offset;
2659                 u32 sg_len, len;
2660
2661                 /* determine if physical DMA addr spans 64K boundary.
2662                  * Note h/w doesn't support 64-bit, so we unconditionally
2663                  * truncate dma_addr_t to u32.
2664                  */
2665                 addr = (u32) sg_dma_address(sg);
2666                 sg_len = sg_dma_len(sg);
2667
2668                 while (sg_len) {
2669                         offset = addr & 0xffff;
2670                         len = sg_len;
2671                         if ((offset + sg_len) > 0x10000)
2672                                 len = 0x10000 - offset;
2673
2674                         ap->prd[idx].addr = cpu_to_le32(addr);
2675                         ap->prd[idx].flags_len = cpu_to_le32(len & 0xffff);
2676                         VPRINTK("PRD[%u] = (0x%X, 0x%X)\n", idx, addr, len);
2677
2678                         idx++;
2679                         sg_len -= len;
2680                         addr += len;
2681                 }
2682         }
2683
2684         if (idx)
2685                 ap->prd[idx - 1].flags_len |= cpu_to_le32(ATA_PRD_EOT);
2686 }
2687 /**
2688  *      ata_check_atapi_dma - Check whether ATAPI DMA can be supported
2689  *      @qc: Metadata associated with taskfile to check
2690  *
2691  *      Allow low-level driver to filter ATA PACKET commands, returning
2692  *      a status indicating whether or not it is OK to use DMA for the
2693  *      supplied PACKET command.
2694  *
2695  *      LOCKING:
2696  *      spin_lock_irqsave(host_set lock)
2697  *
2698  *      RETURNS: 0 when ATAPI DMA can be used
2699  *               nonzero otherwise
2700  */
2701 int ata_check_atapi_dma(struct ata_queued_cmd *qc)
2702 {
2703         struct ata_port *ap = qc->ap;
2704         int rc = 0; /* Assume ATAPI DMA is OK by default */
2705
2706         if (ap->ops->check_atapi_dma)
2707                 rc = ap->ops->check_atapi_dma(qc);
2708
2709         return rc;
2710 }
2711 /**
2712  *      ata_qc_prep - Prepare taskfile for submission
2713  *      @qc: Metadata associated with taskfile to be prepared
2714  *
2715  *      Prepare ATA taskfile for submission.
2716  *
2717  *      LOCKING:
2718  *      spin_lock_irqsave(host_set lock)
2719  */
2720 void ata_qc_prep(struct ata_queued_cmd *qc)
2721 {
2722         if (!(qc->flags & ATA_QCFLAG_DMAMAP))
2723                 return;
2724
2725         ata_fill_sg(qc);
2726 }
2727
2728 /**
2729  *      ata_sg_init_one - Associate command with memory buffer
2730  *      @qc: Command to be associated
2731  *      @buf: Memory buffer
2732  *      @buflen: Length of memory buffer, in bytes.
2733  *
2734  *      Initialize the data-related elements of queued_cmd @qc
2735  *      to point to a single memory buffer, @buf of byte length @buflen.
2736  *
2737  *      LOCKING:
2738  *      spin_lock_irqsave(host_set lock)
2739  */
2740
2741 void ata_sg_init_one(struct ata_queued_cmd *qc, void *buf, unsigned int buflen)
2742 {
2743         struct scatterlist *sg;
2744
2745         qc->flags |= ATA_QCFLAG_SINGLE;
2746
2747         memset(&qc->sgent, 0, sizeof(qc->sgent));
2748         qc->__sg = &qc->sgent;
2749         qc->n_elem = 1;
2750         qc->orig_n_elem = 1;
2751         qc->buf_virt = buf;
2752
2753         sg = qc->__sg;
2754         sg_init_one(sg, buf, buflen);
2755 }
2756
2757 /**
2758  *      ata_sg_init - Associate command with scatter-gather table.
2759  *      @qc: Command to be associated
2760  *      @sg: Scatter-gather table.
2761  *      @n_elem: Number of elements in s/g table.
2762  *
2763  *      Initialize the data-related elements of queued_cmd @qc
2764  *      to point to a scatter-gather table @sg, containing @n_elem
2765  *      elements.
2766  *
2767  *      LOCKING:
2768  *      spin_lock_irqsave(host_set lock)
2769  */
2770
2771 void ata_sg_init(struct ata_queued_cmd *qc, struct scatterlist *sg,
2772                  unsigned int n_elem)
2773 {
2774         qc->flags |= ATA_QCFLAG_SG;
2775         qc->__sg = sg;
2776         qc->n_elem = n_elem;
2777         qc->orig_n_elem = n_elem;
2778 }
2779
2780 /**
2781  *      ata_sg_setup_one - DMA-map the memory buffer associated with a command.
2782  *      @qc: Command with memory buffer to be mapped.
2783  *
2784  *      DMA-map the memory buffer associated with queued_cmd @qc.
2785  *
2786  *      LOCKING:
2787  *      spin_lock_irqsave(host_set lock)
2788  *
2789  *      RETURNS:
2790  *      Zero on success, negative on error.
2791  */
2792
2793 static int ata_sg_setup_one(struct ata_queued_cmd *qc)
2794 {
2795         struct ata_port *ap = qc->ap;
2796         int dir = qc->dma_dir;
2797         struct scatterlist *sg = qc->__sg;
2798         dma_addr_t dma_address;
2799         int trim_sg = 0;
2800
2801         /* we must lengthen transfers to end on a 32-bit boundary */
2802         qc->pad_len = sg->length & 3;
2803         if (qc->pad_len) {
2804                 void *pad_buf = ap->pad + (qc->tag * ATA_DMA_PAD_SZ);
2805                 struct scatterlist *psg = &qc->pad_sgent;
2806
2807                 WARN_ON(qc->dev->class != ATA_DEV_ATAPI);
2808
2809                 memset(pad_buf, 0, ATA_DMA_PAD_SZ);
2810
2811                 if (qc->tf.flags & ATA_TFLAG_WRITE)
2812                         memcpy(pad_buf, qc->buf_virt + sg->length - qc->pad_len,
2813                                qc->pad_len);
2814
2815                 sg_dma_address(psg) = ap->pad_dma + (qc->tag * ATA_DMA_PAD_SZ);
2816                 sg_dma_len(psg) = ATA_DMA_PAD_SZ;
2817                 /* trim sg */
2818                 sg->length -= qc->pad_len;
2819                 if (sg->length == 0)
2820                         trim_sg = 1;
2821
2822                 DPRINTK("padding done, sg->length=%u pad_len=%u\n",
2823                         sg->length, qc->pad_len);
2824         }
2825
2826         if (trim_sg) {
2827                 qc->n_elem--;
2828                 goto skip_map;
2829         }
2830
2831         dma_address = dma_map_single(ap->host_set->dev, qc->buf_virt,
2832                                      sg->length, dir);
2833         if (dma_mapping_error(dma_address)) {
2834                 /* restore sg */
2835                 sg->length += qc->pad_len;
2836                 return -1;
2837         }
2838
2839         sg_dma_address(sg) = dma_address;
2840         sg_dma_len(sg) = sg->length;
2841
2842 skip_map:
2843         DPRINTK("mapped buffer of %d bytes for %s\n", sg_dma_len(sg),
2844                 qc->tf.flags & ATA_TFLAG_WRITE ? "write" : "read");
2845
2846         return 0;
2847 }
2848
2849 /**
2850  *      ata_sg_setup - DMA-map the scatter-gather table associated with a command.
2851  *      @qc: Command with scatter-gather table to be mapped.
2852  *
2853  *      DMA-map the scatter-gather table associated with queued_cmd @qc.
2854  *
2855  *      LOCKING:
2856  *      spin_lock_irqsave(host_set lock)
2857  *
2858  *      RETURNS:
2859  *      Zero on success, negative on error.
2860  *
2861  */
2862
2863 static int ata_sg_setup(struct ata_queued_cmd *qc)
2864 {
2865         struct ata_port *ap = qc->ap;
2866         struct scatterlist *sg = qc->__sg;
2867         struct scatterlist *lsg = &sg[qc->n_elem - 1];
2868         int n_elem, pre_n_elem, dir, trim_sg = 0;
2869
2870         VPRINTK("ENTER, ata%u\n", ap->id);
2871         WARN_ON(!(qc->flags & ATA_QCFLAG_SG));
2872
2873         /* we must lengthen transfers to end on a 32-bit boundary */
2874         qc->pad_len = lsg->length & 3;
2875         if (qc->pad_len) {
2876                 void *pad_buf = ap->pad + (qc->tag * ATA_DMA_PAD_SZ);
2877                 struct scatterlist *psg = &qc->pad_sgent;
2878                 unsigned int offset;
2879
2880                 WARN_ON(qc->dev->class != ATA_DEV_ATAPI);
2881
2882                 memset(pad_buf, 0, ATA_DMA_PAD_SZ);
2883
2884                 /*
2885                  * psg->page/offset are used to copy to-be-written
2886                  * data in this function or read data in ata_sg_clean.
2887                  */
2888                 offset = lsg->offset + lsg->length - qc->pad_len;
2889                 psg->page = nth_page(lsg->page, offset >> PAGE_SHIFT);
2890                 psg->offset = offset_in_page(offset);
2891
2892                 if (qc->tf.flags & ATA_TFLAG_WRITE) {
2893                         void *addr = kmap_atomic(psg->page, KM_IRQ0);
2894                         memcpy(pad_buf, addr + psg->offset, qc->pad_len);
2895                         kunmap_atomic(addr, KM_IRQ0);
2896                 }
2897
2898                 sg_dma_address(psg) = ap->pad_dma + (qc->tag * ATA_DMA_PAD_SZ);
2899                 sg_dma_len(psg) = ATA_DMA_PAD_SZ;
2900                 /* trim last sg */
2901                 lsg->length -= qc->pad_len;
2902                 if (lsg->length == 0)
2903                         trim_sg = 1;
2904
2905                 DPRINTK("padding done, sg[%d].length=%u pad_len=%u\n",
2906                         qc->n_elem - 1, lsg->length, qc->pad_len);
2907         }
2908
2909         pre_n_elem = qc->n_elem;
2910         if (trim_sg && pre_n_elem)
2911                 pre_n_elem--;
2912
2913         if (!pre_n_elem) {
2914                 n_elem = 0;
2915                 goto skip_map;
2916         }
2917
2918         dir = qc->dma_dir;
2919         n_elem = dma_map_sg(ap->host_set->dev, sg, pre_n_elem, dir);
2920         if (n_elem < 1) {
2921                 /* restore last sg */
2922                 lsg->length += qc->pad_len;
2923                 return -1;
2924         }
2925
2926         DPRINTK("%d sg elements mapped\n", n_elem);
2927
2928 skip_map:
2929         qc->n_elem = n_elem;
2930
2931         return 0;
2932 }
2933
2934 /**
2935  *      ata_poll_qc_complete - turn irq back on and finish qc
2936  *      @qc: Command to complete
2937  *      @err_mask: ATA status register content
2938  *
2939  *      LOCKING:
2940  *      None.  (grabs host lock)
2941  */
2942
2943 void ata_poll_qc_complete(struct ata_queued_cmd *qc)
2944 {
2945         struct ata_port *ap = qc->ap;
2946         unsigned long flags;
2947
2948         spin_lock_irqsave(&ap->host_set->lock, flags);
2949         ata_irq_on(ap);
2950         ata_qc_complete(qc);
2951         spin_unlock_irqrestore(&ap->host_set->lock, flags);
2952 }
2953
2954 /**
2955  *      ata_pio_poll - poll using PIO, depending on current state
2956  *      @ap: the target ata_port
2957  *
2958  *      LOCKING:
2959  *      None.  (executing in kernel thread context)
2960  *
2961  *      RETURNS:
2962  *      timeout value to use
2963  */
2964
2965 static unsigned long ata_pio_poll(struct ata_port *ap)
2966 {
2967         struct ata_queued_cmd *qc;
2968         u8 status;
2969         unsigned int poll_state = HSM_ST_UNKNOWN;
2970         unsigned int reg_state = HSM_ST_UNKNOWN;
2971
2972         qc = ata_qc_from_tag(ap, ap->active_tag);
2973         WARN_ON(qc == NULL);
2974
2975         switch (ap->hsm_task_state) {
2976         case HSM_ST:
2977         case HSM_ST_POLL:
2978                 poll_state = HSM_ST_POLL;
2979                 reg_state = HSM_ST;
2980                 break;
2981         case HSM_ST_LAST:
2982         case HSM_ST_LAST_POLL:
2983                 poll_state = HSM_ST_LAST_POLL;
2984                 reg_state = HSM_ST_LAST;
2985                 break;
2986         default:
2987                 BUG();
2988                 break;
2989         }
2990
2991         status = ata_chk_status(ap);
2992         if (status & ATA_BUSY) {
2993                 if (time_after(jiffies, ap->pio_task_timeout)) {
2994                         qc->err_mask |= AC_ERR_TIMEOUT;
2995                         ap->hsm_task_state = HSM_ST_TMOUT;
2996                         return 0;
2997                 }
2998                 ap->hsm_task_state = poll_state;
2999                 return ATA_SHORT_PAUSE;
3000         }
3001
3002         ap->hsm_task_state = reg_state;
3003         return 0;
3004 }
3005
3006 /**
3007  *      ata_pio_complete - check if drive is busy or idle
3008  *      @ap: the target ata_port
3009  *
3010  *      LOCKING:
3011  *      None.  (executing in kernel thread context)
3012  *
3013  *      RETURNS:
3014  *      Zero if qc completed.
3015  *      Non-zero if has next.
3016  */
3017
3018 static int ata_pio_complete (struct ata_port *ap)
3019 {
3020         struct ata_queued_cmd *qc;
3021         u8 drv_stat;
3022
3023         /*
3024          * This is purely heuristic.  This is a fast path.  Sometimes when
3025          * we enter, BSY will be cleared in a chk-status or two.  If not,
3026          * the drive is probably seeking or something.  Snooze for a couple
3027          * msecs, then chk-status again.  If still busy, fall back to
3028          * HSM_ST_LAST_POLL state.
3029          */
3030         drv_stat = ata_busy_wait(ap, ATA_BUSY, 10);
3031         if (drv_stat & ATA_BUSY) {
3032                 msleep(2);
3033                 drv_stat = ata_busy_wait(ap, ATA_BUSY, 10);
3034                 if (drv_stat & ATA_BUSY) {
3035                         ap->hsm_task_state = HSM_ST_LAST_POLL;
3036                         ap->pio_task_timeout = jiffies + ATA_TMOUT_PIO;
3037                         return 1;
3038                 }
3039         }
3040
3041         qc = ata_qc_from_tag(ap, ap->active_tag);
3042         WARN_ON(qc == NULL);
3043
3044         drv_stat = ata_wait_idle(ap);
3045         if (!ata_ok(drv_stat)) {
3046                 qc->err_mask |= __ac_err_mask(drv_stat);
3047                 ap->hsm_task_state = HSM_ST_ERR;
3048                 return 1;
3049         }
3050
3051         ap->hsm_task_state = HSM_ST_IDLE;
3052
3053         WARN_ON(qc->err_mask);
3054         ata_poll_qc_complete(qc);
3055
3056         /* another command may start at this point */
3057
3058         return 0;
3059 }
3060
3061
3062 /**
3063  *      swap_buf_le16 - swap halves of 16-bit words in place
3064  *      @buf:  Buffer to swap
3065  *      @buf_words:  Number of 16-bit words in buffer.
3066  *
3067  *      Swap halves of 16-bit words if needed to convert from
3068  *      little-endian byte order to native cpu byte order, or
3069  *      vice-versa.
3070  *
3071  *      LOCKING:
3072  *      Inherited from caller.
3073  */
3074 void swap_buf_le16(u16 *buf, unsigned int buf_words)
3075 {
3076 #ifdef __BIG_ENDIAN
3077         unsigned int i;
3078
3079         for (i = 0; i < buf_words; i++)
3080                 buf[i] = le16_to_cpu(buf[i]);
3081 #endif /* __BIG_ENDIAN */
3082 }
3083
3084 /**
3085  *      ata_mmio_data_xfer - Transfer data by MMIO
3086  *      @ap: port to read/write
3087  *      @buf: data buffer
3088  *      @buflen: buffer length
3089  *      @write_data: read/write
3090  *
3091  *      Transfer data from/to the device data register by MMIO.
3092  *
3093  *      LOCKING:
3094  *      Inherited from caller.
3095  */
3096
3097 static void ata_mmio_data_xfer(struct ata_port *ap, unsigned char *buf,
3098                                unsigned int buflen, int write_data)
3099 {
3100         unsigned int i;
3101         unsigned int words = buflen >> 1;
3102         u16 *buf16 = (u16 *) buf;
3103         void __iomem *mmio = (void __iomem *)ap->ioaddr.data_addr;
3104
3105         /* Transfer multiple of 2 bytes */
3106         if (write_data) {
3107                 for (i = 0; i < words; i++)
3108                         writew(le16_to_cpu(buf16[i]), mmio);
3109         } else {
3110                 for (i = 0; i < words; i++)
3111                         buf16[i] = cpu_to_le16(readw(mmio));
3112         }
3113
3114         /* Transfer trailing 1 byte, if any. */
3115         if (unlikely(buflen & 0x01)) {
3116                 u16 align_buf[1] = { 0 };
3117                 unsigned char *trailing_buf = buf + buflen - 1;
3118
3119                 if (write_data) {
3120                         memcpy(align_buf, trailing_buf, 1);
3121                         writew(le16_to_cpu(align_buf[0]), mmio);
3122                 } else {
3123                         align_buf[0] = cpu_to_le16(readw(mmio));
3124                         memcpy(trailing_buf, align_buf, 1);
3125                 }
3126         }
3127 }
3128
3129 /**
3130  *      ata_pio_data_xfer - Transfer data by PIO
3131  *      @ap: port to read/write
3132  *      @buf: data buffer
3133  *      @buflen: buffer length
3134  *      @write_data: read/write
3135  *
3136  *      Transfer data from/to the device data register by PIO.
3137  *
3138  *      LOCKING:
3139  *      Inherited from caller.
3140  */
3141
3142 static void ata_pio_data_xfer(struct ata_port *ap, unsigned char *buf,
3143                               unsigned int buflen, int write_data)
3144 {
3145         unsigned int words = buflen >> 1;
3146
3147         /* Transfer multiple of 2 bytes */
3148         if (write_data)
3149                 outsw(ap->ioaddr.data_addr, buf, words);
3150         else
3151                 insw(ap->ioaddr.data_addr, buf, words);
3152
3153         /* Transfer trailing 1 byte, if any. */
3154         if (unlikely(buflen & 0x01)) {
3155                 u16 align_buf[1] = { 0 };
3156                 unsigned char *trailing_buf = buf + buflen - 1;
3157
3158                 if (write_data) {
3159                         memcpy(align_buf, trailing_buf, 1);
3160                         outw(le16_to_cpu(align_buf[0]), ap->ioaddr.data_addr);
3161                 } else {
3162                         align_buf[0] = cpu_to_le16(inw(ap->ioaddr.data_addr));
3163                         memcpy(trailing_buf, align_buf, 1);
3164                 }
3165         }
3166 }
3167
3168 /**
3169  *      ata_data_xfer - Transfer data from/to the data register.
3170  *      @ap: port to read/write
3171  *      @buf: data buffer
3172  *      @buflen: buffer length
3173  *      @do_write: read/write
3174  *
3175  *      Transfer data from/to the device data register.
3176  *
3177  *      LOCKING:
3178  *      Inherited from caller.
3179  */
3180
3181 static void ata_data_xfer(struct ata_port *ap, unsigned char *buf,
3182                           unsigned int buflen, int do_write)
3183 {
3184         /* Make the crap hardware pay the costs not the good stuff */
3185         if (unlikely(ap->flags & ATA_FLAG_IRQ_MASK)) {
3186                 unsigned long flags;
3187                 local_irq_save(flags);
3188                 if (ap->flags & ATA_FLAG_MMIO)
3189                         ata_mmio_data_xfer(ap, buf, buflen, do_write);
3190                 else
3191                         ata_pio_data_xfer(ap, buf, buflen, do_write);
3192                 local_irq_restore(flags);
3193         } else {
3194                 if (ap->flags & ATA_FLAG_MMIO)
3195                         ata_mmio_data_xfer(ap, buf, buflen, do_write);
3196                 else
3197                         ata_pio_data_xfer(ap, buf, buflen, do_write);
3198         }
3199 }
3200
3201 /**
3202  *      ata_pio_sector - Transfer ATA_SECT_SIZE (512 bytes) of data.
3203  *      @qc: Command on going
3204  *
3205  *      Transfer ATA_SECT_SIZE of data from/to the ATA device.
3206  *
3207  *      LOCKING:
3208  *      Inherited from caller.
3209  */
3210
3211 static void ata_pio_sector(struct ata_queued_cmd *qc)
3212 {
3213         int do_write = (qc->tf.flags & ATA_TFLAG_WRITE);
3214         struct scatterlist *sg = qc->__sg;
3215         struct ata_port *ap = qc->ap;
3216         struct page *page;
3217         unsigned int offset;
3218         unsigned char *buf;
3219
3220         if (qc->cursect == (qc->nsect - 1))
3221                 ap->hsm_task_state = HSM_ST_LAST;
3222
3223         page = sg[qc->cursg].page;
3224         offset = sg[qc->cursg].offset + qc->cursg_ofs * ATA_SECT_SIZE;
3225
3226         /* get the current page and offset */
3227         page = nth_page(page, (offset >> PAGE_SHIFT));
3228         offset %= PAGE_SIZE;
3229
3230         DPRINTK("data %s\n", qc->tf.flags & ATA_TFLAG_WRITE ? "write" : "read");
3231
3232         if (PageHighMem(page)) {
3233                 unsigned long flags;
3234
3235                 local_irq_save(flags);
3236                 buf = kmap_atomic(page, KM_IRQ0);
3237
3238                 /* do the actual data transfer */
3239                 ata_data_xfer(ap, buf + offset, ATA_SECT_SIZE, do_write);
3240
3241                 kunmap_atomic(buf, KM_IRQ0);
3242                 local_irq_restore(flags);
3243         } else {
3244                 buf = page_address(page);
3245                 ata_data_xfer(ap, buf + offset, ATA_SECT_SIZE, do_write);
3246         }
3247
3248         qc->cursect++;
3249         qc->cursg_ofs++;
3250
3251         if ((qc->cursg_ofs * ATA_SECT_SIZE) == (&sg[qc->cursg])->length) {
3252                 qc->cursg++;
3253                 qc->cursg_ofs = 0;
3254         }
3255 }
3256
3257 /**
3258  *      ata_pio_sectors - Transfer one or many 512-byte sectors.
3259  *      @qc: Command on going
3260  *
3261  *      Transfer one or many ATA_SECT_SIZE of data from/to the 
3262  *      ATA device for the DRQ request.
3263  *
3264  *      LOCKING:
3265  *      Inherited from caller.
3266  */
3267
3268 static void ata_pio_sectors(struct ata_queued_cmd *qc)
3269 {
3270         if (is_multi_taskfile(&qc->tf)) {
3271                 /* READ/WRITE MULTIPLE */
3272                 unsigned int nsect;
3273
3274                 WARN_ON(qc->dev->multi_count == 0);
3275
3276                 nsect = min(qc->nsect - qc->cursect, qc->dev->multi_count);
3277                 while (nsect--)
3278                         ata_pio_sector(qc);
3279         } else
3280                 ata_pio_sector(qc);
3281 }
3282
3283 /**
3284  *      atapi_send_cdb - Write CDB bytes to hardware
3285  *      @ap: Port to which ATAPI device is attached.
3286  *      @qc: Taskfile currently active
3287  *
3288  *      When device has indicated its readiness to accept
3289  *      a CDB, this function is called.  Send the CDB.
3290  *
3291  *      LOCKING:
3292  *      caller.
3293  */
3294
3295 static void atapi_send_cdb(struct ata_port *ap, struct ata_queued_cmd *qc)
3296 {