2 * libata-core.c - helper library for ATA
4 * Maintained by: Jeff Garzik <jgarzik@pobox.com>
5 * Please ALWAYS copy linux-ide@vger.kernel.org
8 * Copyright 2003-2004 Red Hat, Inc. All rights reserved.
9 * Copyright 2003-2004 Jeff Garzik
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)
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.
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.
27 * libata documentation is available via 'make {ps|pdf}docs',
28 * as Documentation/DocBook/libata.*
30 * Hardware documentation available from http://www.t13.org/ and
31 * http://www.sata-io.org/
33 * Standards documents from:
34 * http://www.t13.org (ATA standards, PCI DMA IDE spec)
35 * http://www.t10.org (SCSI MMC - for ATAPI MMC)
36 * http://www.sata-io.org (SATA)
37 * http://www.compactflash.org (CF)
38 * http://www.qic.org (QIC157 - Tape and DSC)
39 * http://www.ce-ata.org (CE-ATA: not supported)
43 #include <linux/kernel.h>
44 #include <linux/module.h>
45 #include <linux/pci.h>
46 #include <linux/init.h>
47 #include <linux/list.h>
49 #include <linux/spinlock.h>
50 #include <linux/blkdev.h>
51 #include <linux/delay.h>
52 #include <linux/timer.h>
53 #include <linux/interrupt.h>
54 #include <linux/completion.h>
55 #include <linux/suspend.h>
56 #include <linux/workqueue.h>
57 #include <linux/scatterlist.h>
59 #include <scsi/scsi.h>
60 #include <scsi/scsi_cmnd.h>
61 #include <scsi/scsi_host.h>
62 #include <linux/libata.h>
63 #include <asm/byteorder.h>
64 #include <linux/cdrom.h>
69 /* debounce timing parameters in msecs { interval, duration, timeout } */
70 const unsigned long sata_deb_timing_normal[] = { 5, 100, 2000 };
71 const unsigned long sata_deb_timing_hotplug[] = { 25, 500, 2000 };
72 const unsigned long sata_deb_timing_long[] = { 100, 2000, 5000 };
74 const struct ata_port_operations ata_base_port_ops = {
75 .prereset = ata_std_prereset,
76 .postreset = ata_std_postreset,
77 .error_handler = ata_std_error_handler,
80 const struct ata_port_operations sata_port_ops = {
81 .inherits = &ata_base_port_ops,
83 .qc_defer = ata_std_qc_defer,
84 .hardreset = sata_std_hardreset,
87 static unsigned int ata_dev_init_params(struct ata_device *dev,
88 u16 heads, u16 sectors);
89 static unsigned int ata_dev_set_xfermode(struct ata_device *dev);
90 static unsigned int ata_dev_set_feature(struct ata_device *dev,
91 u8 enable, u8 feature);
92 static void ata_dev_xfermask(struct ata_device *dev);
93 static unsigned long ata_dev_blacklisted(const struct ata_device *dev);
95 unsigned int ata_print_id = 1;
96 static struct workqueue_struct *ata_wq;
98 struct workqueue_struct *ata_aux_wq;
100 struct ata_force_param {
104 unsigned long xfer_mask;
105 unsigned int horkage_on;
106 unsigned int horkage_off;
110 struct ata_force_ent {
113 struct ata_force_param param;
116 static struct ata_force_ent *ata_force_tbl;
117 static int ata_force_tbl_size;
119 static char ata_force_param_buf[PAGE_SIZE] __initdata;
120 /* param_buf is thrown away after initialization, disallow read */
121 module_param_string(force, ata_force_param_buf, sizeof(ata_force_param_buf), 0);
122 MODULE_PARM_DESC(force, "Force ATA configurations including cable type, link speed and transfer mode (see Documentation/kernel-parameters.txt for details)");
124 static int atapi_enabled = 1;
125 module_param(atapi_enabled, int, 0444);
126 MODULE_PARM_DESC(atapi_enabled, "Enable discovery of ATAPI devices (0=off, 1=on)");
128 static int atapi_dmadir = 0;
129 module_param(atapi_dmadir, int, 0444);
130 MODULE_PARM_DESC(atapi_dmadir, "Enable ATAPI DMADIR bridge support (0=off, 1=on)");
132 int atapi_passthru16 = 1;
133 module_param(atapi_passthru16, int, 0444);
134 MODULE_PARM_DESC(atapi_passthru16, "Enable ATA_16 passthru for ATAPI devices; on by default (0=off, 1=on)");
137 module_param_named(fua, libata_fua, int, 0444);
138 MODULE_PARM_DESC(fua, "FUA support (0=off, 1=on)");
140 static int ata_ignore_hpa;
141 module_param_named(ignore_hpa, ata_ignore_hpa, int, 0644);
142 MODULE_PARM_DESC(ignore_hpa, "Ignore HPA limit (0=keep BIOS limits, 1=ignore limits, using full disk)");
144 static int libata_dma_mask = ATA_DMA_MASK_ATA|ATA_DMA_MASK_ATAPI|ATA_DMA_MASK_CFA;
145 module_param_named(dma, libata_dma_mask, int, 0444);
146 MODULE_PARM_DESC(dma, "DMA enable/disable (0x1==ATA, 0x2==ATAPI, 0x4==CF)");
148 static int ata_probe_timeout;
149 module_param(ata_probe_timeout, int, 0444);
150 MODULE_PARM_DESC(ata_probe_timeout, "Set ATA probing timeout (seconds)");
152 int libata_noacpi = 0;
153 module_param_named(noacpi, libata_noacpi, int, 0444);
154 MODULE_PARM_DESC(noacpi, "Disables the use of ACPI in probe/suspend/resume when set");
156 int libata_allow_tpm = 0;
157 module_param_named(allow_tpm, libata_allow_tpm, int, 0444);
158 MODULE_PARM_DESC(allow_tpm, "Permit the use of TPM commands");
160 MODULE_AUTHOR("Jeff Garzik");
161 MODULE_DESCRIPTION("Library module for ATA devices");
162 MODULE_LICENSE("GPL");
163 MODULE_VERSION(DRV_VERSION);
167 * Iterator helpers. Don't use directly.
170 * Host lock or EH context.
172 struct ata_link *__ata_port_next_link(struct ata_port *ap,
173 struct ata_link *link, bool dev_only)
175 /* NULL link indicates start of iteration */
177 if (dev_only && sata_pmp_attached(ap))
182 /* we just iterated over the host master link, what's next? */
183 if (link == &ap->link) {
184 if (!sata_pmp_attached(ap)) {
185 if (unlikely(ap->slave_link) && !dev_only)
186 return ap->slave_link;
192 /* slave_link excludes PMP */
193 if (unlikely(link == ap->slave_link))
196 /* iterate to the next PMP link */
197 if (++link < ap->pmp_link + ap->nr_pmp_links)
203 * ata_dev_phys_link - find physical link for a device
204 * @dev: ATA device to look up physical link for
206 * Look up physical link which @dev is attached to. Note that
207 * this is different from @dev->link only when @dev is on slave
208 * link. For all other cases, it's the same as @dev->link.
214 * Pointer to the found physical link.
216 struct ata_link *ata_dev_phys_link(struct ata_device *dev)
218 struct ata_port *ap = dev->link->ap;
224 return ap->slave_link;
228 * ata_force_cbl - force cable type according to libata.force
229 * @ap: ATA port of interest
231 * Force cable type according to libata.force and whine about it.
232 * The last entry which has matching port number is used, so it
233 * can be specified as part of device force parameters. For
234 * example, both "a:40c,1.00:udma4" and "1.00:40c,udma4" have the
240 void ata_force_cbl(struct ata_port *ap)
244 for (i = ata_force_tbl_size - 1; i >= 0; i--) {
245 const struct ata_force_ent *fe = &ata_force_tbl[i];
247 if (fe->port != -1 && fe->port != ap->print_id)
250 if (fe->param.cbl == ATA_CBL_NONE)
253 ap->cbl = fe->param.cbl;
254 ata_port_printk(ap, KERN_NOTICE,
255 "FORCE: cable set to %s\n", fe->param.name);
261 * ata_force_link_limits - force link limits according to libata.force
262 * @link: ATA link of interest
264 * Force link flags and SATA spd limit according to libata.force
265 * and whine about it. When only the port part is specified
266 * (e.g. 1:), the limit applies to all links connected to both
267 * the host link and all fan-out ports connected via PMP. If the
268 * device part is specified as 0 (e.g. 1.00:), it specifies the
269 * first fan-out link not the host link. Device number 15 always
270 * points to the host link whether PMP is attached or not. If the
271 * controller has slave link, device number 16 points to it.
276 static void ata_force_link_limits(struct ata_link *link)
278 bool did_spd = false;
279 int linkno = link->pmp;
282 if (ata_is_host_link(link))
285 for (i = ata_force_tbl_size - 1; i >= 0; i--) {
286 const struct ata_force_ent *fe = &ata_force_tbl[i];
288 if (fe->port != -1 && fe->port != link->ap->print_id)
291 if (fe->device != -1 && fe->device != linkno)
294 /* only honor the first spd limit */
295 if (!did_spd && fe->param.spd_limit) {
296 link->hw_sata_spd_limit = (1 << fe->param.spd_limit) - 1;
297 ata_link_printk(link, KERN_NOTICE,
298 "FORCE: PHY spd limit set to %s\n",
303 /* let lflags stack */
304 if (fe->param.lflags) {
305 link->flags |= fe->param.lflags;
306 ata_link_printk(link, KERN_NOTICE,
307 "FORCE: link flag 0x%x forced -> 0x%x\n",
308 fe->param.lflags, link->flags);
314 * ata_force_xfermask - force xfermask according to libata.force
315 * @dev: ATA device of interest
317 * Force xfer_mask according to libata.force and whine about it.
318 * For consistency with link selection, device number 15 selects
319 * the first device connected to the host link.
324 static void ata_force_xfermask(struct ata_device *dev)
326 int devno = dev->link->pmp + dev->devno;
327 int alt_devno = devno;
330 /* allow n.15/16 for devices attached to host port */
331 if (ata_is_host_link(dev->link))
334 for (i = ata_force_tbl_size - 1; i >= 0; i--) {
335 const struct ata_force_ent *fe = &ata_force_tbl[i];
336 unsigned long pio_mask, mwdma_mask, udma_mask;
338 if (fe->port != -1 && fe->port != dev->link->ap->print_id)
341 if (fe->device != -1 && fe->device != devno &&
342 fe->device != alt_devno)
345 if (!fe->param.xfer_mask)
348 ata_unpack_xfermask(fe->param.xfer_mask,
349 &pio_mask, &mwdma_mask, &udma_mask);
351 dev->udma_mask = udma_mask;
352 else if (mwdma_mask) {
354 dev->mwdma_mask = mwdma_mask;
358 dev->pio_mask = pio_mask;
361 ata_dev_printk(dev, KERN_NOTICE,
362 "FORCE: xfer_mask set to %s\n", fe->param.name);
368 * ata_force_horkage - force horkage according to libata.force
369 * @dev: ATA device of interest
371 * Force horkage according to libata.force and whine about it.
372 * For consistency with link selection, device number 15 selects
373 * the first device connected to the host link.
378 static void ata_force_horkage(struct ata_device *dev)
380 int devno = dev->link->pmp + dev->devno;
381 int alt_devno = devno;
384 /* allow n.15/16 for devices attached to host port */
385 if (ata_is_host_link(dev->link))
388 for (i = 0; i < ata_force_tbl_size; i++) {
389 const struct ata_force_ent *fe = &ata_force_tbl[i];
391 if (fe->port != -1 && fe->port != dev->link->ap->print_id)
394 if (fe->device != -1 && fe->device != devno &&
395 fe->device != alt_devno)
398 if (!(~dev->horkage & fe->param.horkage_on) &&
399 !(dev->horkage & fe->param.horkage_off))
402 dev->horkage |= fe->param.horkage_on;
403 dev->horkage &= ~fe->param.horkage_off;
405 ata_dev_printk(dev, KERN_NOTICE,
406 "FORCE: horkage modified (%s)\n", fe->param.name);
411 * atapi_cmd_type - Determine ATAPI command type from SCSI opcode
412 * @opcode: SCSI opcode
414 * Determine ATAPI command type from @opcode.
420 * ATAPI_{READ|WRITE|READ_CD|PASS_THRU|MISC}
422 int atapi_cmd_type(u8 opcode)
431 case GPCMD_WRITE_AND_VERIFY_10:
435 case GPCMD_READ_CD_MSF:
436 return ATAPI_READ_CD;
440 if (atapi_passthru16)
441 return ATAPI_PASS_THRU;
449 * ata_tf_to_fis - Convert ATA taskfile to SATA FIS structure
450 * @tf: Taskfile to convert
451 * @pmp: Port multiplier port
452 * @is_cmd: This FIS is for command
453 * @fis: Buffer into which data will output
455 * Converts a standard ATA taskfile to a Serial ATA
456 * FIS structure (Register - Host to Device).
459 * Inherited from caller.
461 void ata_tf_to_fis(const struct ata_taskfile *tf, u8 pmp, int is_cmd, u8 *fis)
463 fis[0] = 0x27; /* Register - Host to Device FIS */
464 fis[1] = pmp & 0xf; /* Port multiplier number*/
466 fis[1] |= (1 << 7); /* bit 7 indicates Command FIS */
468 fis[2] = tf->command;
469 fis[3] = tf->feature;
476 fis[8] = tf->hob_lbal;
477 fis[9] = tf->hob_lbam;
478 fis[10] = tf->hob_lbah;
479 fis[11] = tf->hob_feature;
482 fis[13] = tf->hob_nsect;
493 * ata_tf_from_fis - Convert SATA FIS to ATA taskfile
494 * @fis: Buffer from which data will be input
495 * @tf: Taskfile to output
497 * Converts a serial ATA FIS structure to a standard ATA taskfile.
500 * Inherited from caller.
503 void ata_tf_from_fis(const u8 *fis, struct ata_taskfile *tf)
505 tf->command = fis[2]; /* status */
506 tf->feature = fis[3]; /* error */
513 tf->hob_lbal = fis[8];
514 tf->hob_lbam = fis[9];
515 tf->hob_lbah = fis[10];
518 tf->hob_nsect = fis[13];
521 static const u8 ata_rw_cmds[] = {
525 ATA_CMD_READ_MULTI_EXT,
526 ATA_CMD_WRITE_MULTI_EXT,
530 ATA_CMD_WRITE_MULTI_FUA_EXT,
534 ATA_CMD_PIO_READ_EXT,
535 ATA_CMD_PIO_WRITE_EXT,
548 ATA_CMD_WRITE_FUA_EXT
552 * ata_rwcmd_protocol - set taskfile r/w commands and protocol
553 * @tf: command to examine and configure
554 * @dev: device tf belongs to
556 * Examine the device configuration and tf->flags to calculate
557 * the proper read/write commands and protocol to use.
562 static int ata_rwcmd_protocol(struct ata_taskfile *tf, struct ata_device *dev)
566 int index, fua, lba48, write;
568 fua = (tf->flags & ATA_TFLAG_FUA) ? 4 : 0;
569 lba48 = (tf->flags & ATA_TFLAG_LBA48) ? 2 : 0;
570 write = (tf->flags & ATA_TFLAG_WRITE) ? 1 : 0;
572 if (dev->flags & ATA_DFLAG_PIO) {
573 tf->protocol = ATA_PROT_PIO;
574 index = dev->multi_count ? 0 : 8;
575 } else if (lba48 && (dev->link->ap->flags & ATA_FLAG_PIO_LBA48)) {
576 /* Unable to use DMA due to host limitation */
577 tf->protocol = ATA_PROT_PIO;
578 index = dev->multi_count ? 0 : 8;
580 tf->protocol = ATA_PROT_DMA;
584 cmd = ata_rw_cmds[index + fua + lba48 + write];
593 * ata_tf_read_block - Read block address from ATA taskfile
594 * @tf: ATA taskfile of interest
595 * @dev: ATA device @tf belongs to
600 * Read block address from @tf. This function can handle all
601 * three address formats - LBA, LBA48 and CHS. tf->protocol and
602 * flags select the address format to use.
605 * Block address read from @tf.
607 u64 ata_tf_read_block(struct ata_taskfile *tf, struct ata_device *dev)
611 if (tf->flags & ATA_TFLAG_LBA) {
612 if (tf->flags & ATA_TFLAG_LBA48) {
613 block |= (u64)tf->hob_lbah << 40;
614 block |= (u64)tf->hob_lbam << 32;
615 block |= tf->hob_lbal << 24;
617 block |= (tf->device & 0xf) << 24;
619 block |= tf->lbah << 16;
620 block |= tf->lbam << 8;
625 cyl = tf->lbam | (tf->lbah << 8);
626 head = tf->device & 0xf;
629 block = (cyl * dev->heads + head) * dev->sectors + sect;
636 * ata_build_rw_tf - Build ATA taskfile for given read/write request
637 * @tf: Target ATA taskfile
638 * @dev: ATA device @tf belongs to
639 * @block: Block address
640 * @n_block: Number of blocks
641 * @tf_flags: RW/FUA etc...
647 * Build ATA taskfile @tf for read/write request described by
648 * @block, @n_block, @tf_flags and @tag on @dev.
652 * 0 on success, -ERANGE if the request is too large for @dev,
653 * -EINVAL if the request is invalid.
655 int ata_build_rw_tf(struct ata_taskfile *tf, struct ata_device *dev,
656 u64 block, u32 n_block, unsigned int tf_flags,
659 tf->flags |= ATA_TFLAG_ISADDR | ATA_TFLAG_DEVICE;
660 tf->flags |= tf_flags;
662 if (ata_ncq_enabled(dev) && likely(tag != ATA_TAG_INTERNAL)) {
664 if (!lba_48_ok(block, n_block))
667 tf->protocol = ATA_PROT_NCQ;
668 tf->flags |= ATA_TFLAG_LBA | ATA_TFLAG_LBA48;
670 if (tf->flags & ATA_TFLAG_WRITE)
671 tf->command = ATA_CMD_FPDMA_WRITE;
673 tf->command = ATA_CMD_FPDMA_READ;
675 tf->nsect = tag << 3;
676 tf->hob_feature = (n_block >> 8) & 0xff;
677 tf->feature = n_block & 0xff;
679 tf->hob_lbah = (block >> 40) & 0xff;
680 tf->hob_lbam = (block >> 32) & 0xff;
681 tf->hob_lbal = (block >> 24) & 0xff;
682 tf->lbah = (block >> 16) & 0xff;
683 tf->lbam = (block >> 8) & 0xff;
684 tf->lbal = block & 0xff;
687 if (tf->flags & ATA_TFLAG_FUA)
688 tf->device |= 1 << 7;
689 } else if (dev->flags & ATA_DFLAG_LBA) {
690 tf->flags |= ATA_TFLAG_LBA;
692 if (lba_28_ok(block, n_block)) {
694 tf->device |= (block >> 24) & 0xf;
695 } else if (lba_48_ok(block, n_block)) {
696 if (!(dev->flags & ATA_DFLAG_LBA48))
700 tf->flags |= ATA_TFLAG_LBA48;
702 tf->hob_nsect = (n_block >> 8) & 0xff;
704 tf->hob_lbah = (block >> 40) & 0xff;
705 tf->hob_lbam = (block >> 32) & 0xff;
706 tf->hob_lbal = (block >> 24) & 0xff;
708 /* request too large even for LBA48 */
711 if (unlikely(ata_rwcmd_protocol(tf, dev) < 0))
714 tf->nsect = n_block & 0xff;
716 tf->lbah = (block >> 16) & 0xff;
717 tf->lbam = (block >> 8) & 0xff;
718 tf->lbal = block & 0xff;
720 tf->device |= ATA_LBA;
723 u32 sect, head, cyl, track;
725 /* The request -may- be too large for CHS addressing. */
726 if (!lba_28_ok(block, n_block))
729 if (unlikely(ata_rwcmd_protocol(tf, dev) < 0))
732 /* Convert LBA to CHS */
733 track = (u32)block / dev->sectors;
734 cyl = track / dev->heads;
735 head = track % dev->heads;
736 sect = (u32)block % dev->sectors + 1;
738 DPRINTK("block %u track %u cyl %u head %u sect %u\n",
739 (u32)block, track, cyl, head, sect);
741 /* Check whether the converted CHS can fit.
745 if ((cyl >> 16) || (head >> 4) || (sect >> 8) || (!sect))
748 tf->nsect = n_block & 0xff; /* Sector count 0 means 256 sectors */
759 * ata_pack_xfermask - Pack pio, mwdma and udma masks into xfer_mask
760 * @pio_mask: pio_mask
761 * @mwdma_mask: mwdma_mask
762 * @udma_mask: udma_mask
764 * Pack @pio_mask, @mwdma_mask and @udma_mask into a single
765 * unsigned int xfer_mask.
773 unsigned long ata_pack_xfermask(unsigned long pio_mask,
774 unsigned long mwdma_mask,
775 unsigned long udma_mask)
777 return ((pio_mask << ATA_SHIFT_PIO) & ATA_MASK_PIO) |
778 ((mwdma_mask << ATA_SHIFT_MWDMA) & ATA_MASK_MWDMA) |
779 ((udma_mask << ATA_SHIFT_UDMA) & ATA_MASK_UDMA);
783 * ata_unpack_xfermask - Unpack xfer_mask into pio, mwdma and udma masks
784 * @xfer_mask: xfer_mask to unpack
785 * @pio_mask: resulting pio_mask
786 * @mwdma_mask: resulting mwdma_mask
787 * @udma_mask: resulting udma_mask
789 * Unpack @xfer_mask into @pio_mask, @mwdma_mask and @udma_mask.
790 * Any NULL distination masks will be ignored.
792 void ata_unpack_xfermask(unsigned long xfer_mask, unsigned long *pio_mask,
793 unsigned long *mwdma_mask, unsigned long *udma_mask)
796 *pio_mask = (xfer_mask & ATA_MASK_PIO) >> ATA_SHIFT_PIO;
798 *mwdma_mask = (xfer_mask & ATA_MASK_MWDMA) >> ATA_SHIFT_MWDMA;
800 *udma_mask = (xfer_mask & ATA_MASK_UDMA) >> ATA_SHIFT_UDMA;
803 static const struct ata_xfer_ent {
807 { ATA_SHIFT_PIO, ATA_NR_PIO_MODES, XFER_PIO_0 },
808 { ATA_SHIFT_MWDMA, ATA_NR_MWDMA_MODES, XFER_MW_DMA_0 },
809 { ATA_SHIFT_UDMA, ATA_NR_UDMA_MODES, XFER_UDMA_0 },
814 * ata_xfer_mask2mode - Find matching XFER_* for the given xfer_mask
815 * @xfer_mask: xfer_mask of interest
817 * Return matching XFER_* value for @xfer_mask. Only the highest
818 * bit of @xfer_mask is considered.
824 * Matching XFER_* value, 0xff if no match found.
826 u8 ata_xfer_mask2mode(unsigned long xfer_mask)
828 int highbit = fls(xfer_mask) - 1;
829 const struct ata_xfer_ent *ent;
831 for (ent = ata_xfer_tbl; ent->shift >= 0; ent++)
832 if (highbit >= ent->shift && highbit < ent->shift + ent->bits)
833 return ent->base + highbit - ent->shift;
838 * ata_xfer_mode2mask - Find matching xfer_mask for XFER_*
839 * @xfer_mode: XFER_* of interest
841 * Return matching xfer_mask for @xfer_mode.
847 * Matching xfer_mask, 0 if no match found.
849 unsigned long ata_xfer_mode2mask(u8 xfer_mode)
851 const struct ata_xfer_ent *ent;
853 for (ent = ata_xfer_tbl; ent->shift >= 0; ent++)
854 if (xfer_mode >= ent->base && xfer_mode < ent->base + ent->bits)
855 return ((2 << (ent->shift + xfer_mode - ent->base)) - 1)
856 & ~((1 << ent->shift) - 1);
861 * ata_xfer_mode2shift - Find matching xfer_shift for XFER_*
862 * @xfer_mode: XFER_* of interest
864 * Return matching xfer_shift for @xfer_mode.
870 * Matching xfer_shift, -1 if no match found.
872 int ata_xfer_mode2shift(unsigned long xfer_mode)
874 const struct ata_xfer_ent *ent;
876 for (ent = ata_xfer_tbl; ent->shift >= 0; ent++)
877 if (xfer_mode >= ent->base && xfer_mode < ent->base + ent->bits)
883 * ata_mode_string - convert xfer_mask to string
884 * @xfer_mask: mask of bits supported; only highest bit counts.
886 * Determine string which represents the highest speed
887 * (highest bit in @modemask).
893 * Constant C string representing highest speed listed in
894 * @mode_mask, or the constant C string "<n/a>".
896 const char *ata_mode_string(unsigned long xfer_mask)
898 static const char * const xfer_mode_str[] = {
922 highbit = fls(xfer_mask) - 1;
923 if (highbit >= 0 && highbit < ARRAY_SIZE(xfer_mode_str))
924 return xfer_mode_str[highbit];
928 static const char *sata_spd_string(unsigned int spd)
930 static const char * const spd_str[] = {
935 if (spd == 0 || (spd - 1) >= ARRAY_SIZE(spd_str))
937 return spd_str[spd - 1];
940 void ata_dev_disable(struct ata_device *dev)
942 if (ata_dev_enabled(dev)) {
943 if (ata_msg_drv(dev->link->ap))
944 ata_dev_printk(dev, KERN_WARNING, "disabled\n");
945 ata_acpi_on_disable(dev);
946 ata_down_xfermask_limit(dev, ATA_DNXFER_FORCE_PIO0 |
952 static int ata_dev_set_dipm(struct ata_device *dev, enum link_pm policy)
954 struct ata_link *link = dev->link;
955 struct ata_port *ap = link->ap;
957 unsigned int err_mask;
961 * disallow DIPM for drivers which haven't set
962 * ATA_FLAG_IPM. This is because when DIPM is enabled,
963 * phy ready will be set in the interrupt status on
964 * state changes, which will cause some drivers to
965 * think there are errors - additionally drivers will
966 * need to disable hot plug.
968 if (!(ap->flags & ATA_FLAG_IPM) || !ata_dev_enabled(dev)) {
969 ap->pm_policy = NOT_AVAILABLE;
974 * For DIPM, we will only enable it for the
977 * Why? Because Disks are too stupid to know that
978 * If the host rejects a request to go to SLUMBER
979 * they should retry at PARTIAL, and instead it
980 * just would give up. So, for medium_power to
981 * work at all, we need to only allow HIPM.
983 rc = sata_scr_read(link, SCR_CONTROL, &scontrol);
989 /* no restrictions on IPM transitions */
990 scontrol &= ~(0x3 << 8);
991 rc = sata_scr_write(link, SCR_CONTROL, scontrol);
996 if (dev->flags & ATA_DFLAG_DIPM)
997 err_mask = ata_dev_set_feature(dev,
998 SETFEATURES_SATA_ENABLE, SATA_DIPM);
1001 /* allow IPM to PARTIAL */
1002 scontrol &= ~(0x1 << 8);
1003 scontrol |= (0x2 << 8);
1004 rc = sata_scr_write(link, SCR_CONTROL, scontrol);
1009 * we don't have to disable DIPM since IPM flags
1010 * disallow transitions to SLUMBER, which effectively
1011 * disable DIPM if it does not support PARTIAL
1015 case MAX_PERFORMANCE:
1016 /* disable all IPM transitions */
1017 scontrol |= (0x3 << 8);
1018 rc = sata_scr_write(link, SCR_CONTROL, scontrol);
1023 * we don't have to disable DIPM since IPM flags
1024 * disallow all transitions which effectively
1025 * disable DIPM anyway.
1030 /* FIXME: handle SET FEATURES failure */
1037 * ata_dev_enable_pm - enable SATA interface power management
1038 * @dev: device to enable power management
1039 * @policy: the link power management policy
1041 * Enable SATA Interface power management. This will enable
1042 * Device Interface Power Management (DIPM) for min_power
1043 * policy, and then call driver specific callbacks for
1044 * enabling Host Initiated Power management.
1047 * Returns: -EINVAL if IPM is not supported, 0 otherwise.
1049 void ata_dev_enable_pm(struct ata_device *dev, enum link_pm policy)
1052 struct ata_port *ap = dev->link->ap;
1054 /* set HIPM first, then DIPM */
1055 if (ap->ops->enable_pm)
1056 rc = ap->ops->enable_pm(ap, policy);
1059 rc = ata_dev_set_dipm(dev, policy);
1063 ap->pm_policy = MAX_PERFORMANCE;
1065 ap->pm_policy = policy;
1066 return /* rc */; /* hopefully we can use 'rc' eventually */
1071 * ata_dev_disable_pm - disable SATA interface power management
1072 * @dev: device to disable power management
1074 * Disable SATA Interface power management. This will disable
1075 * Device Interface Power Management (DIPM) without changing
1076 * policy, call driver specific callbacks for disabling Host
1077 * Initiated Power management.
1082 static void ata_dev_disable_pm(struct ata_device *dev)
1084 struct ata_port *ap = dev->link->ap;
1086 ata_dev_set_dipm(dev, MAX_PERFORMANCE);
1087 if (ap->ops->disable_pm)
1088 ap->ops->disable_pm(ap);
1090 #endif /* CONFIG_PM */
1092 void ata_lpm_schedule(struct ata_port *ap, enum link_pm policy)
1094 ap->pm_policy = policy;
1095 ap->link.eh_info.action |= ATA_EH_LPM;
1096 ap->link.eh_info.flags |= ATA_EHI_NO_AUTOPSY;
1097 ata_port_schedule_eh(ap);
1101 static void ata_lpm_enable(struct ata_host *host)
1103 struct ata_link *link;
1104 struct ata_port *ap;
1105 struct ata_device *dev;
1108 for (i = 0; i < host->n_ports; i++) {
1109 ap = host->ports[i];
1110 ata_port_for_each_link(link, ap) {
1111 ata_link_for_each_dev(dev, link)
1112 ata_dev_disable_pm(dev);
1117 static void ata_lpm_disable(struct ata_host *host)
1121 for (i = 0; i < host->n_ports; i++) {
1122 struct ata_port *ap = host->ports[i];
1123 ata_lpm_schedule(ap, ap->pm_policy);
1126 #endif /* CONFIG_PM */
1129 * ata_dev_classify - determine device type based on ATA-spec signature
1130 * @tf: ATA taskfile register set for device to be identified
1132 * Determine from taskfile register contents whether a device is
1133 * ATA or ATAPI, as per "Signature and persistence" section
1134 * of ATA/PI spec (volume 1, sect 5.14).
1140 * Device type, %ATA_DEV_ATA, %ATA_DEV_ATAPI, %ATA_DEV_PMP or
1141 * %ATA_DEV_UNKNOWN the event of failure.
1143 unsigned int ata_dev_classify(const struct ata_taskfile *tf)
1145 /* Apple's open source Darwin code hints that some devices only
1146 * put a proper signature into the LBA mid/high registers,
1147 * So, we only check those. It's sufficient for uniqueness.
1149 * ATA/ATAPI-7 (d1532v1r1: Feb. 19, 2003) specified separate
1150 * signatures for ATA and ATAPI devices attached on SerialATA,
1151 * 0x3c/0xc3 and 0x69/0x96 respectively. However, SerialATA
1152 * spec has never mentioned about using different signatures
1153 * for ATA/ATAPI devices. Then, Serial ATA II: Port
1154 * Multiplier specification began to use 0x69/0x96 to identify
1155 * port multpliers and 0x3c/0xc3 to identify SEMB device.
1156 * ATA/ATAPI-7 dropped descriptions about 0x3c/0xc3 and
1157 * 0x69/0x96 shortly and described them as reserved for
1160 * We follow the current spec and consider that 0x69/0x96
1161 * identifies a port multiplier and 0x3c/0xc3 a SEMB device.
1163 if ((tf->lbam == 0) && (tf->lbah == 0)) {
1164 DPRINTK("found ATA device by sig\n");
1168 if ((tf->lbam == 0x14) && (tf->lbah == 0xeb)) {
1169 DPRINTK("found ATAPI device by sig\n");
1170 return ATA_DEV_ATAPI;
1173 if ((tf->lbam == 0x69) && (tf->lbah == 0x96)) {
1174 DPRINTK("found PMP device by sig\n");
1178 if ((tf->lbam == 0x3c) && (tf->lbah == 0xc3)) {
1179 printk(KERN_INFO "ata: SEMB device ignored\n");
1180 return ATA_DEV_SEMB_UNSUP; /* not yet */
1183 DPRINTK("unknown device\n");
1184 return ATA_DEV_UNKNOWN;
1188 * ata_id_string - Convert IDENTIFY DEVICE page into string
1189 * @id: IDENTIFY DEVICE results we will examine
1190 * @s: string into which data is output
1191 * @ofs: offset into identify device page
1192 * @len: length of string to return. must be an even number.
1194 * The strings in the IDENTIFY DEVICE page are broken up into
1195 * 16-bit chunks. Run through the string, and output each
1196 * 8-bit chunk linearly, regardless of platform.
1202 void ata_id_string(const u16 *id, unsigned char *s,
1203 unsigned int ofs, unsigned int len)
1224 * ata_id_c_string - Convert IDENTIFY DEVICE page into C string
1225 * @id: IDENTIFY DEVICE results we will examine
1226 * @s: string into which data is output
1227 * @ofs: offset into identify device page
1228 * @len: length of string to return. must be an odd number.
1230 * This function is identical to ata_id_string except that it
1231 * trims trailing spaces and terminates the resulting string with
1232 * null. @len must be actual maximum length (even number) + 1.
1237 void ata_id_c_string(const u16 *id, unsigned char *s,
1238 unsigned int ofs, unsigned int len)
1242 ata_id_string(id, s, ofs, len - 1);
1244 p = s + strnlen(s, len - 1);
1245 while (p > s && p[-1] == ' ')
1250 static u64 ata_id_n_sectors(const u16 *id)
1252 if (ata_id_has_lba(id)) {
1253 if (ata_id_has_lba48(id))
1254 return ata_id_u64(id, 100);
1256 return ata_id_u32(id, 60);
1258 if (ata_id_current_chs_valid(id))
1259 return ata_id_u32(id, 57);
1261 return id[1] * id[3] * id[6];
1265 u64 ata_tf_to_lba48(const struct ata_taskfile *tf)
1269 sectors |= ((u64)(tf->hob_lbah & 0xff)) << 40;
1270 sectors |= ((u64)(tf->hob_lbam & 0xff)) << 32;
1271 sectors |= ((u64)(tf->hob_lbal & 0xff)) << 24;
1272 sectors |= (tf->lbah & 0xff) << 16;
1273 sectors |= (tf->lbam & 0xff) << 8;
1274 sectors |= (tf->lbal & 0xff);
1279 u64 ata_tf_to_lba(const struct ata_taskfile *tf)
1283 sectors |= (tf->device & 0x0f) << 24;
1284 sectors |= (tf->lbah & 0xff) << 16;
1285 sectors |= (tf->lbam & 0xff) << 8;
1286 sectors |= (tf->lbal & 0xff);
1292 * ata_read_native_max_address - Read native max address
1293 * @dev: target device
1294 * @max_sectors: out parameter for the result native max address
1296 * Perform an LBA48 or LBA28 native size query upon the device in
1300 * 0 on success, -EACCES if command is aborted by the drive.
1301 * -EIO on other errors.
1303 static int ata_read_native_max_address(struct ata_device *dev, u64 *max_sectors)
1305 unsigned int err_mask;
1306 struct ata_taskfile tf;
1307 int lba48 = ata_id_has_lba48(dev->id);
1309 ata_tf_init(dev, &tf);
1311 /* always clear all address registers */
1312 tf.flags |= ATA_TFLAG_DEVICE | ATA_TFLAG_ISADDR;
1315 tf.command = ATA_CMD_READ_NATIVE_MAX_EXT;
1316 tf.flags |= ATA_TFLAG_LBA48;
1318 tf.command = ATA_CMD_READ_NATIVE_MAX;
1320 tf.protocol |= ATA_PROT_NODATA;
1321 tf.device |= ATA_LBA;
1323 err_mask = ata_exec_internal(dev, &tf, NULL, DMA_NONE, NULL, 0, 0);
1325 ata_dev_printk(dev, KERN_WARNING, "failed to read native "
1326 "max address (err_mask=0x%x)\n", err_mask);
1327 if (err_mask == AC_ERR_DEV && (tf.feature & ATA_ABORTED))
1333 *max_sectors = ata_tf_to_lba48(&tf) + 1;
1335 *max_sectors = ata_tf_to_lba(&tf) + 1;
1336 if (dev->horkage & ATA_HORKAGE_HPA_SIZE)
1342 * ata_set_max_sectors - Set max sectors
1343 * @dev: target device
1344 * @new_sectors: new max sectors value to set for the device
1346 * Set max sectors of @dev to @new_sectors.
1349 * 0 on success, -EACCES if command is aborted or denied (due to
1350 * previous non-volatile SET_MAX) by the drive. -EIO on other
1353 static int ata_set_max_sectors(struct ata_device *dev, u64 new_sectors)
1355 unsigned int err_mask;
1356 struct ata_taskfile tf;
1357 int lba48 = ata_id_has_lba48(dev->id);
1361 ata_tf_init(dev, &tf);
1363 tf.flags |= ATA_TFLAG_DEVICE | ATA_TFLAG_ISADDR;
1366 tf.command = ATA_CMD_SET_MAX_EXT;
1367 tf.flags |= ATA_TFLAG_LBA48;
1369 tf.hob_lbal = (new_sectors >> 24) & 0xff;
1370 tf.hob_lbam = (new_sectors >> 32) & 0xff;
1371 tf.hob_lbah = (new_sectors >> 40) & 0xff;
1373 tf.command = ATA_CMD_SET_MAX;
1375 tf.device |= (new_sectors >> 24) & 0xf;
1378 tf.protocol |= ATA_PROT_NODATA;
1379 tf.device |= ATA_LBA;
1381 tf.lbal = (new_sectors >> 0) & 0xff;
1382 tf.lbam = (new_sectors >> 8) & 0xff;
1383 tf.lbah = (new_sectors >> 16) & 0xff;
1385 err_mask = ata_exec_internal(dev, &tf, NULL, DMA_NONE, NULL, 0, 0);
1387 ata_dev_printk(dev, KERN_WARNING, "failed to set "
1388 "max address (err_mask=0x%x)\n", err_mask);
1389 if (err_mask == AC_ERR_DEV &&
1390 (tf.feature & (ATA_ABORTED | ATA_IDNF)))
1399 * ata_hpa_resize - Resize a device with an HPA set
1400 * @dev: Device to resize
1402 * Read the size of an LBA28 or LBA48 disk with HPA features and resize
1403 * it if required to the full size of the media. The caller must check
1404 * the drive has the HPA feature set enabled.
1407 * 0 on success, -errno on failure.
1409 static int ata_hpa_resize(struct ata_device *dev)
1411 struct ata_eh_context *ehc = &dev->link->eh_context;
1412 int print_info = ehc->i.flags & ATA_EHI_PRINTINFO;
1413 u64 sectors = ata_id_n_sectors(dev->id);
1417 /* do we need to do it? */
1418 if (dev->class != ATA_DEV_ATA ||
1419 !ata_id_has_lba(dev->id) || !ata_id_hpa_enabled(dev->id) ||
1420 (dev->horkage & ATA_HORKAGE_BROKEN_HPA))
1423 /* read native max address */
1424 rc = ata_read_native_max_address(dev, &native_sectors);
1426 /* If device aborted the command or HPA isn't going to
1427 * be unlocked, skip HPA resizing.
1429 if (rc == -EACCES || !ata_ignore_hpa) {
1430 ata_dev_printk(dev, KERN_WARNING, "HPA support seems "
1431 "broken, skipping HPA handling\n");
1432 dev->horkage |= ATA_HORKAGE_BROKEN_HPA;
1434 /* we can continue if device aborted the command */
1442 /* nothing to do? */
1443 if (native_sectors <= sectors || !ata_ignore_hpa) {
1444 if (!print_info || native_sectors == sectors)
1447 if (native_sectors > sectors)
1448 ata_dev_printk(dev, KERN_INFO,
1449 "HPA detected: current %llu, native %llu\n",
1450 (unsigned long long)sectors,
1451 (unsigned long long)native_sectors);
1452 else if (native_sectors < sectors)
1453 ata_dev_printk(dev, KERN_WARNING,
1454 "native sectors (%llu) is smaller than "
1456 (unsigned long long)native_sectors,
1457 (unsigned long long)sectors);
1461 /* let's unlock HPA */
1462 rc = ata_set_max_sectors(dev, native_sectors);
1463 if (rc == -EACCES) {
1464 /* if device aborted the command, skip HPA resizing */
1465 ata_dev_printk(dev, KERN_WARNING, "device aborted resize "
1466 "(%llu -> %llu), skipping HPA handling\n",
1467 (unsigned long long)sectors,
1468 (unsigned long long)native_sectors);
1469 dev->horkage |= ATA_HORKAGE_BROKEN_HPA;
1474 /* re-read IDENTIFY data */
1475 rc = ata_dev_reread_id(dev, 0);
1477 ata_dev_printk(dev, KERN_ERR, "failed to re-read IDENTIFY "
1478 "data after HPA resizing\n");
1483 u64 new_sectors = ata_id_n_sectors(dev->id);
1484 ata_dev_printk(dev, KERN_INFO,
1485 "HPA unlocked: %llu -> %llu, native %llu\n",
1486 (unsigned long long)sectors,
1487 (unsigned long long)new_sectors,
1488 (unsigned long long)native_sectors);
1495 * ata_dump_id - IDENTIFY DEVICE info debugging output
1496 * @id: IDENTIFY DEVICE page to dump
1498 * Dump selected 16-bit words from the given IDENTIFY DEVICE
1505 static inline void ata_dump_id(const u16 *id)
1507 DPRINTK("49==0x%04x "
1517 DPRINTK("80==0x%04x "
1527 DPRINTK("88==0x%04x "
1534 * ata_id_xfermask - Compute xfermask from the given IDENTIFY data
1535 * @id: IDENTIFY data to compute xfer mask from
1537 * Compute the xfermask for this device. This is not as trivial
1538 * as it seems if we must consider early devices correctly.
1540 * FIXME: pre IDE drive timing (do we care ?).
1548 unsigned long ata_id_xfermask(const u16 *id)
1550 unsigned long pio_mask, mwdma_mask, udma_mask;
1552 /* Usual case. Word 53 indicates word 64 is valid */
1553 if (id[ATA_ID_FIELD_VALID] & (1 << 1)) {
1554 pio_mask = id[ATA_ID_PIO_MODES] & 0x03;
1558 /* If word 64 isn't valid then Word 51 high byte holds
1559 * the PIO timing number for the maximum. Turn it into
1562 u8 mode = (id[ATA_ID_OLD_PIO_MODES] >> 8) & 0xFF;
1563 if (mode < 5) /* Valid PIO range */
1564 pio_mask = (2 << mode) - 1;
1568 /* But wait.. there's more. Design your standards by
1569 * committee and you too can get a free iordy field to
1570 * process. However its the speeds not the modes that
1571 * are supported... Note drivers using the timing API
1572 * will get this right anyway
1576 mwdma_mask = id[ATA_ID_MWDMA_MODES] & 0x07;
1578 if (ata_id_is_cfa(id)) {
1580 * Process compact flash extended modes
1582 int pio = id[163] & 0x7;
1583 int dma = (id[163] >> 3) & 7;
1586 pio_mask |= (1 << 5);
1588 pio_mask |= (1 << 6);
1590 mwdma_mask |= (1 << 3);
1592 mwdma_mask |= (1 << 4);
1596 if (id[ATA_ID_FIELD_VALID] & (1 << 2))
1597 udma_mask = id[ATA_ID_UDMA_MODES] & 0xff;
1599 return ata_pack_xfermask(pio_mask, mwdma_mask, udma_mask);
1603 * ata_pio_queue_task - Queue port_task
1604 * @ap: The ata_port to queue port_task for
1605 * @data: data for @fn to use
1606 * @delay: delay time in msecs for workqueue function
1608 * Schedule @fn(@data) for execution after @delay jiffies using
1609 * port_task. There is one port_task per port and it's the
1610 * user(low level driver)'s responsibility to make sure that only
1611 * one task is active at any given time.
1613 * libata core layer takes care of synchronization between
1614 * port_task and EH. ata_pio_queue_task() may be ignored for EH
1618 * Inherited from caller.
1620 void ata_pio_queue_task(struct ata_port *ap, void *data, unsigned long delay)
1622 ap->port_task_data = data;
1624 /* may fail if ata_port_flush_task() in progress */
1625 queue_delayed_work(ata_wq, &ap->port_task, msecs_to_jiffies(delay));
1629 * ata_port_flush_task - Flush port_task
1630 * @ap: The ata_port to flush port_task for
1632 * After this function completes, port_task is guranteed not to
1633 * be running or scheduled.
1636 * Kernel thread context (may sleep)
1638 void ata_port_flush_task(struct ata_port *ap)
1642 cancel_rearming_delayed_work(&ap->port_task);
1644 if (ata_msg_ctl(ap))
1645 ata_port_printk(ap, KERN_DEBUG, "%s: EXIT\n", __func__);
1648 static void ata_qc_complete_internal(struct ata_queued_cmd *qc)
1650 struct completion *waiting = qc->private_data;
1656 * ata_exec_internal_sg - execute libata internal command
1657 * @dev: Device to which the command is sent
1658 * @tf: Taskfile registers for the command and the result
1659 * @cdb: CDB for packet command
1660 * @dma_dir: Data tranfer direction of the command
1661 * @sgl: sg list for the data buffer of the command
1662 * @n_elem: Number of sg entries
1663 * @timeout: Timeout in msecs (0 for default)
1665 * Executes libata internal command with timeout. @tf contains
1666 * command on entry and result on return. Timeout and error
1667 * conditions are reported via return value. No recovery action
1668 * is taken after a command times out. It's caller's duty to
1669 * clean up after timeout.
1672 * None. Should be called with kernel context, might sleep.
1675 * Zero on success, AC_ERR_* mask on failure
1677 unsigned ata_exec_internal_sg(struct ata_device *dev,
1678 struct ata_taskfile *tf, const u8 *cdb,
1679 int dma_dir, struct scatterlist *sgl,
1680 unsigned int n_elem, unsigned long timeout)
1682 struct ata_link *link = dev->link;
1683 struct ata_port *ap = link->ap;
1684 u8 command = tf->command;
1685 int auto_timeout = 0;
1686 struct ata_queued_cmd *qc;
1687 unsigned int tag, preempted_tag;
1688 u32 preempted_sactive, preempted_qc_active;
1689 int preempted_nr_active_links;
1690 DECLARE_COMPLETION_ONSTACK(wait);
1691 unsigned long flags;
1692 unsigned int err_mask;
1695 spin_lock_irqsave(ap->lock, flags);
1697 /* no internal command while frozen */
1698 if (ap->pflags & ATA_PFLAG_FROZEN) {
1699 spin_unlock_irqrestore(ap->lock, flags);
1700 return AC_ERR_SYSTEM;
1703 /* initialize internal qc */
1705 /* XXX: Tag 0 is used for drivers with legacy EH as some
1706 * drivers choke if any other tag is given. This breaks
1707 * ata_tag_internal() test for those drivers. Don't use new
1708 * EH stuff without converting to it.
1710 if (ap->ops->error_handler)
1711 tag = ATA_TAG_INTERNAL;
1715 qc = __ata_qc_from_tag(ap, tag);
1723 preempted_tag = link->active_tag;
1724 preempted_sactive = link->sactive;
1725 preempted_qc_active = ap->qc_active;
1726 preempted_nr_active_links = ap->nr_active_links;
1727 link->active_tag = ATA_TAG_POISON;
1730 ap->nr_active_links = 0;
1732 /* prepare & issue qc */
1735 memcpy(qc->cdb, cdb, ATAPI_CDB_LEN);
1736 qc->flags |= ATA_QCFLAG_RESULT_TF;
1737 qc->dma_dir = dma_dir;
1738 if (dma_dir != DMA_NONE) {
1739 unsigned int i, buflen = 0;
1740 struct scatterlist *sg;
1742 for_each_sg(sgl, sg, n_elem, i)
1743 buflen += sg->length;
1745 ata_sg_init(qc, sgl, n_elem);
1746 qc->nbytes = buflen;
1749 qc->private_data = &wait;
1750 qc->complete_fn = ata_qc_complete_internal;
1754 spin_unlock_irqrestore(ap->lock, flags);
1757 if (ata_probe_timeout)
1758 timeout = ata_probe_timeout * 1000;
1760 timeout = ata_internal_cmd_timeout(dev, command);
1765 rc = wait_for_completion_timeout(&wait, msecs_to_jiffies(timeout));
1767 ata_port_flush_task(ap);
1770 spin_lock_irqsave(ap->lock, flags);
1772 /* We're racing with irq here. If we lose, the
1773 * following test prevents us from completing the qc
1774 * twice. If we win, the port is frozen and will be
1775 * cleaned up by ->post_internal_cmd().
1777 if (qc->flags & ATA_QCFLAG_ACTIVE) {
1778 qc->err_mask |= AC_ERR_TIMEOUT;
1780 if (ap->ops->error_handler)
1781 ata_port_freeze(ap);
1783 ata_qc_complete(qc);
1785 if (ata_msg_warn(ap))
1786 ata_dev_printk(dev, KERN_WARNING,
1787 "qc timeout (cmd 0x%x)\n", command);
1790 spin_unlock_irqrestore(ap->lock, flags);
1793 /* do post_internal_cmd */
1794 if (ap->ops->post_internal_cmd)
1795 ap->ops->post_internal_cmd(qc);
1797 /* perform minimal error analysis */
1798 if (qc->flags & ATA_QCFLAG_FAILED) {
1799 if (qc->result_tf.command & (ATA_ERR | ATA_DF))
1800 qc->err_mask |= AC_ERR_DEV;
1803 qc->err_mask |= AC_ERR_OTHER;
1805 if (qc->err_mask & ~AC_ERR_OTHER)
1806 qc->err_mask &= ~AC_ERR_OTHER;
1810 spin_lock_irqsave(ap->lock, flags);
1812 *tf = qc->result_tf;
1813 err_mask = qc->err_mask;
1816 link->active_tag = preempted_tag;
1817 link->sactive = preempted_sactive;
1818 ap->qc_active = preempted_qc_active;
1819 ap->nr_active_links = preempted_nr_active_links;
1821 /* XXX - Some LLDDs (sata_mv) disable port on command failure.
1822 * Until those drivers are fixed, we detect the condition
1823 * here, fail the command with AC_ERR_SYSTEM and reenable the
1826 * Note that this doesn't change any behavior as internal
1827 * command failure results in disabling the device in the
1828 * higher layer for LLDDs without new reset/EH callbacks.
1830 * Kill the following code as soon as those drivers are fixed.
1832 if (ap->flags & ATA_FLAG_DISABLED) {
1833 err_mask |= AC_ERR_SYSTEM;
1837 spin_unlock_irqrestore(ap->lock, flags);
1839 if ((err_mask & AC_ERR_TIMEOUT) && auto_timeout)
1840 ata_internal_cmd_timed_out(dev, command);
1846 * ata_exec_internal - execute libata internal command
1847 * @dev: Device to which the command is sent
1848 * @tf: Taskfile registers for the command and the result
1849 * @cdb: CDB for packet command
1850 * @dma_dir: Data tranfer direction of the command
1851 * @buf: Data buffer of the command
1852 * @buflen: Length of data buffer
1853 * @timeout: Timeout in msecs (0 for default)
1855 * Wrapper around ata_exec_internal_sg() which takes simple
1856 * buffer instead of sg list.
1859 * None. Should be called with kernel context, might sleep.
1862 * Zero on success, AC_ERR_* mask on failure
1864 unsigned ata_exec_internal(struct ata_device *dev,
1865 struct ata_taskfile *tf, const u8 *cdb,
1866 int dma_dir, void *buf, unsigned int buflen,
1867 unsigned long timeout)
1869 struct scatterlist *psg = NULL, sg;
1870 unsigned int n_elem = 0;
1872 if (dma_dir != DMA_NONE) {
1874 sg_init_one(&sg, buf, buflen);
1879 return ata_exec_internal_sg(dev, tf, cdb, dma_dir, psg, n_elem,
1884 * ata_do_simple_cmd - execute simple internal command
1885 * @dev: Device to which the command is sent
1886 * @cmd: Opcode to execute
1888 * Execute a 'simple' command, that only consists of the opcode
1889 * 'cmd' itself, without filling any other registers
1892 * Kernel thread context (may sleep).
1895 * Zero on success, AC_ERR_* mask on failure
1897 unsigned int ata_do_simple_cmd(struct ata_device *dev, u8 cmd)
1899 struct ata_taskfile tf;
1901 ata_tf_init(dev, &tf);
1904 tf.flags |= ATA_TFLAG_DEVICE;
1905 tf.protocol = ATA_PROT_NODATA;
1907 return ata_exec_internal(dev, &tf, NULL, DMA_NONE, NULL, 0, 0);
1911 * ata_pio_need_iordy - check if iordy needed
1914 * Check if the current speed of the device requires IORDY. Used
1915 * by various controllers for chip configuration.
1918 unsigned int ata_pio_need_iordy(const struct ata_device *adev)
1920 /* Controller doesn't support IORDY. Probably a pointless check
1921 as the caller should know this */
1922 if (adev->link->ap->flags & ATA_FLAG_NO_IORDY)
1924 /* PIO3 and higher it is mandatory */
1925 if (adev->pio_mode > XFER_PIO_2)
1927 /* We turn it on when possible */
1928 if (ata_id_has_iordy(adev->id))
1934 * ata_pio_mask_no_iordy - Return the non IORDY mask
1937 * Compute the highest mode possible if we are not using iordy. Return
1938 * -1 if no iordy mode is available.
1941 static u32 ata_pio_mask_no_iordy(const struct ata_device *adev)
1943 /* If we have no drive specific rule, then PIO 2 is non IORDY */
1944 if (adev->id[ATA_ID_FIELD_VALID] & 2) { /* EIDE */
1945 u16 pio = adev->id[ATA_ID_EIDE_PIO];
1946 /* Is the speed faster than the drive allows non IORDY ? */
1948 /* This is cycle times not frequency - watch the logic! */
1949 if (pio > 240) /* PIO2 is 240nS per cycle */
1950 return 3 << ATA_SHIFT_PIO;
1951 return 7 << ATA_SHIFT_PIO;
1954 return 3 << ATA_SHIFT_PIO;
1958 * ata_do_dev_read_id - default ID read method
1960 * @tf: proposed taskfile
1963 * Issue the identify taskfile and hand back the buffer containing
1964 * identify data. For some RAID controllers and for pre ATA devices
1965 * this function is wrapped or replaced by the driver
1967 unsigned int ata_do_dev_read_id(struct ata_device *dev,
1968 struct ata_taskfile *tf, u16 *id)
1970 return ata_exec_internal(dev, tf, NULL, DMA_FROM_DEVICE,
1971 id, sizeof(id[0]) * ATA_ID_WORDS, 0);
1975 * ata_dev_read_id - Read ID data from the specified device
1976 * @dev: target device
1977 * @p_class: pointer to class of the target device (may be changed)
1978 * @flags: ATA_READID_* flags
1979 * @id: buffer to read IDENTIFY data into
1981 * Read ID data from the specified device. ATA_CMD_ID_ATA is
1982 * performed on ATA devices and ATA_CMD_ID_ATAPI on ATAPI
1983 * devices. This function also issues ATA_CMD_INIT_DEV_PARAMS
1984 * for pre-ATA4 drives.
1986 * FIXME: ATA_CMD_ID_ATA is optional for early drives and right
1987 * now we abort if we hit that case.
1990 * Kernel thread context (may sleep)
1993 * 0 on success, -errno otherwise.
1995 int ata_dev_read_id(struct ata_device *dev, unsigned int *p_class,
1996 unsigned int flags, u16 *id)
1998 struct ata_port *ap = dev->link->ap;
1999 unsigned int class = *p_class;
2000 struct ata_taskfile tf;
2001 unsigned int err_mask = 0;
2003 int may_fallback = 1, tried_spinup = 0;
2006 if (ata_msg_ctl(ap))
2007 ata_dev_printk(dev, KERN_DEBUG, "%s: ENTER\n", __func__);
2010 ata_tf_init(dev, &tf);
2014 tf.command = ATA_CMD_ID_ATA;
2017 tf.command = ATA_CMD_ID_ATAPI;
2021 reason = "unsupported class";
2025 tf.protocol = ATA_PROT_PIO;
2027 /* Some devices choke if TF registers contain garbage. Make
2028 * sure those are properly initialized.
2030 tf.flags |= ATA_TFLAG_ISADDR | ATA_TFLAG_DEVICE;
2032 /* Device presence detection is unreliable on some
2033 * controllers. Always poll IDENTIFY if available.
2035 tf.flags |= ATA_TFLAG_POLLING;
2037 if (ap->ops->read_id)
2038 err_mask = ap->ops->read_id(dev, &tf, id);
2040 err_mask = ata_do_dev_read_id(dev, &tf, id);
2043 if (err_mask & AC_ERR_NODEV_HINT) {
2044 ata_dev_printk(dev, KERN_DEBUG,
2045 "NODEV after polling detection\n");
2049 if ((err_mask == AC_ERR_DEV) && (tf.feature & ATA_ABORTED)) {
2050 /* Device or controller might have reported
2051 * the wrong device class. Give a shot at the
2052 * other IDENTIFY if the current one is
2053 * aborted by the device.
2058 if (class == ATA_DEV_ATA)
2059 class = ATA_DEV_ATAPI;
2061 class = ATA_DEV_ATA;
2065 /* Control reaches here iff the device aborted
2066 * both flavors of IDENTIFYs which happens
2067 * sometimes with phantom devices.
2069 ata_dev_printk(dev, KERN_DEBUG,
2070 "both IDENTIFYs aborted, assuming NODEV\n");
2075 reason = "I/O error";
2079 /* Falling back doesn't make sense if ID data was read
2080 * successfully at least once.
2084 swap_buf_le16(id, ATA_ID_WORDS);
2088 reason = "device reports invalid type";
2090 if (class == ATA_DEV_ATA) {
2091 if (!ata_id_is_ata(id) && !ata_id_is_cfa(id))
2094 if (ata_id_is_ata(id))
2098 if (!tried_spinup && (id[2] == 0x37c8 || id[2] == 0x738c)) {
2101 * Drive powered-up in standby mode, and requires a specific
2102 * SET_FEATURES spin-up subcommand before it will accept
2103 * anything other than the original IDENTIFY command.
2105 err_mask = ata_dev_set_feature(dev, SETFEATURES_SPINUP, 0);
2106 if (err_mask && id[2] != 0x738c) {
2108 reason = "SPINUP failed";
2112 * If the drive initially returned incomplete IDENTIFY info,
2113 * we now must reissue the IDENTIFY command.
2115 if (id[2] == 0x37c8)
2119 if ((flags & ATA_READID_POSTRESET) && class == ATA_DEV_ATA) {
2121 * The exact sequence expected by certain pre-ATA4 drives is:
2123 * IDENTIFY (optional in early ATA)
2124 * INITIALIZE DEVICE PARAMETERS (later IDE and ATA)
2126 * Some drives were very specific about that exact sequence.
2128 * Note that ATA4 says lba is mandatory so the second check
2129 * shoud never trigger.
2131 if (ata_id_major_version(id) < 4 || !ata_id_has_lba(id)) {
2132 err_mask = ata_dev_init_params(dev, id[3], id[6]);
2135 reason = "INIT_DEV_PARAMS failed";
2139 /* current CHS translation info (id[53-58]) might be
2140 * changed. reread the identify device info.
2142 flags &= ~ATA_READID_POSTRESET;
2152 if (ata_msg_warn(ap))
2153 ata_dev_printk(dev, KERN_WARNING, "failed to IDENTIFY "
2154 "(%s, err_mask=0x%x)\n", reason, err_mask);
2158 static inline u8 ata_dev_knobble(struct ata_device *dev)
2160 struct ata_port *ap = dev->link->ap;
2161 return ((ap->cbl == ATA_CBL_SATA) && (!ata_id_is_sata(dev->id)));
2164 static void ata_dev_config_ncq(struct ata_device *dev,
2165 char *desc, size_t desc_sz)
2167 struct ata_port *ap = dev->link->ap;
2168 int hdepth = 0, ddepth = ata_id_queue_depth(dev->id);
2170 if (!ata_id_has_ncq(dev->id)) {
2174 if (dev->horkage & ATA_HORKAGE_NONCQ) {
2175 snprintf(desc, desc_sz, "NCQ (not used)");
2178 if (ap->flags & ATA_FLAG_NCQ) {
2179 hdepth = min(ap->scsi_host->can_queue, ATA_MAX_QUEUE - 1);
2180 dev->flags |= ATA_DFLAG_NCQ;
2183 if (hdepth >= ddepth)
2184 snprintf(desc, desc_sz, "NCQ (depth %d)", ddepth);
2186 snprintf(desc, desc_sz, "NCQ (depth %d/%d)", hdepth, ddepth);
2190 * ata_dev_configure - Configure the specified ATA/ATAPI device
2191 * @dev: Target device to configure
2193 * Configure @dev according to @dev->id. Generic and low-level
2194 * driver specific fixups are also applied.
2197 * Kernel thread context (may sleep)
2200 * 0 on success, -errno otherwise
2202 int ata_dev_configure(struct ata_device *dev)
2204 struct ata_port *ap = dev->link->ap;
2205 struct ata_eh_context *ehc = &dev->link->eh_context;
2206 int print_info = ehc->i.flags & ATA_EHI_PRINTINFO;
2207 const u16 *id = dev->id;
2208 unsigned long xfer_mask;
2209 char revbuf[7]; /* XYZ-99\0 */
2210 char fwrevbuf[ATA_ID_FW_REV_LEN+1];
2211 char modelbuf[ATA_ID_PROD_LEN+1];
2214 if (!ata_dev_enabled(dev) && ata_msg_info(ap)) {
2215 ata_dev_printk(dev, KERN_INFO, "%s: ENTER/EXIT -- nodev\n",
2220 if (ata_msg_probe(ap))
2221 ata_dev_printk(dev, KERN_DEBUG, "%s: ENTER\n", __func__);
2224 dev->horkage |= ata_dev_blacklisted(dev);
2225 ata_force_horkage(dev);
2227 if (dev->horkage & ATA_HORKAGE_DISABLE) {
2228 ata_dev_printk(dev, KERN_INFO,
2229 "unsupported device, disabling\n");
2230 ata_dev_disable(dev);
2234 if ((!atapi_enabled || (ap->flags & ATA_FLAG_NO_ATAPI)) &&
2235 dev->class == ATA_DEV_ATAPI) {
2236 ata_dev_printk(dev, KERN_WARNING,
2237 "WARNING: ATAPI is %s, device ignored.\n",
2238 atapi_enabled ? "not supported with this driver"
2240 ata_dev_disable(dev);
2244 /* let ACPI work its magic */
2245 rc = ata_acpi_on_devcfg(dev);
2249 /* massage HPA, do it early as it might change IDENTIFY data */
2250 rc = ata_hpa_resize(dev);
2254 /* print device capabilities */
2255 if (ata_msg_probe(ap))
2256 ata_dev_printk(dev, KERN_DEBUG,
2257 "%s: cfg 49:%04x 82:%04x 83:%04x 84:%04x "
2258 "85:%04x 86:%04x 87:%04x 88:%04x\n",
2260 id[49], id[82], id[83], id[84],
2261 id[85], id[86], id[87], id[88]);
2263 /* initialize to-be-configured parameters */
2264 dev->flags &= ~ATA_DFLAG_CFG_MASK;
2265 dev->max_sectors = 0;
2273 * common ATA, ATAPI feature tests
2276 /* find max transfer mode; for printk only */
2277 xfer_mask = ata_id_xfermask(id);
2279 if (ata_msg_probe(ap))
2282 /* SCSI only uses 4-char revisions, dump full 8 chars from ATA */
2283 ata_id_c_string(dev->id, fwrevbuf, ATA_ID_FW_REV,
2286 ata_id_c_string(dev->id, modelbuf, ATA_ID_PROD,
2289 /* ATA-specific feature tests */
2290 if (dev->class == ATA_DEV_ATA) {
2291 if (ata_id_is_cfa(id)) {
2292 if (id[162] & 1) /* CPRM may make this media unusable */
2293 ata_dev_printk(dev, KERN_WARNING,
2294 "supports DRM functions and may "
2295 "not be fully accessable.\n");
2296 snprintf(revbuf, 7, "CFA");
2298 snprintf(revbuf, 7, "ATA-%d", ata_id_major_version(id));
2299 /* Warn the user if the device has TPM extensions */
2300 if (ata_id_has_tpm(id))
2301 ata_dev_printk(dev, KERN_WARNING,
2302 "supports DRM functions and may "
2303 "not be fully accessable.\n");
2306 dev->n_sectors = ata_id_n_sectors(id);
2308 if (dev->id[59] & 0x100)
2309 dev->multi_count = dev->id[59] & 0xff;
2311 if (ata_id_has_lba(id)) {
2312 const char *lba_desc;
2316 dev->flags |= ATA_DFLAG_LBA;
2317 if (ata_id_has_lba48(id)) {
2318 dev->flags |= ATA_DFLAG_LBA48;
2321 if (dev->n_sectors >= (1UL << 28) &&
2322 ata_id_has_flush_ext(id))
2323 dev->flags |= ATA_DFLAG_FLUSH_EXT;
2327 ata_dev_config_ncq(dev, ncq_desc, sizeof(ncq_desc));
2329 /* print device info to dmesg */
2330 if (ata_msg_drv(ap) && print_info) {
2331 ata_dev_printk(dev, KERN_INFO,
2332 "%s: %s, %s, max %s\n",
2333 revbuf, modelbuf, fwrevbuf,
2334 ata_mode_string(xfer_mask));
2335 ata_dev_printk(dev, KERN_INFO,
2336 "%Lu sectors, multi %u: %s %s\n",
2337 (unsigned long long)dev->n_sectors,
2338 dev->multi_count, lba_desc, ncq_desc);
2343 /* Default translation */
2344 dev->cylinders = id[1];
2346 dev->sectors = id[6];
2348 if (ata_id_current_chs_valid(id)) {
2349 /* Current CHS translation is valid. */
2350 dev->cylinders = id[54];
2351 dev->heads = id[55];
2352 dev->sectors = id[56];
2355 /* print device info to dmesg */
2356 if (ata_msg_drv(ap) && print_info) {
2357 ata_dev_printk(dev, KERN_INFO,
2358 "%s: %s, %s, max %s\n",
2359 revbuf, modelbuf, fwrevbuf,
2360 ata_mode_string(xfer_mask));
2361 ata_dev_printk(dev, KERN_INFO,
2362 "%Lu sectors, multi %u, CHS %u/%u/%u\n",
2363 (unsigned long long)dev->n_sectors,
2364 dev->multi_count, dev->cylinders,
2365 dev->heads, dev->sectors);
2372 /* ATAPI-specific feature tests */
2373 else if (dev->class == ATA_DEV_ATAPI) {
2374 const char *cdb_intr_string = "";
2375 const char *atapi_an_string = "";
2376 const char *dma_dir_string = "";
2379 rc = atapi_cdb_len(id);
2380 if ((rc < 12) || (rc > ATAPI_CDB_LEN)) {
2381 if (ata_msg_warn(ap))
2382 ata_dev_printk(dev, KERN_WARNING,
2383 "unsupported CDB len\n");
2387 dev->cdb_len = (unsigned int) rc;
2389 /* Enable ATAPI AN if both the host and device have
2390 * the support. If PMP is attached, SNTF is required
2391 * to enable ATAPI AN to discern between PHY status
2392 * changed notifications and ATAPI ANs.
2394 if ((ap->flags & ATA_FLAG_AN) && ata_id_has_atapi_AN(id) &&
2395 (!sata_pmp_attached(ap) ||
2396 sata_scr_read(&ap->link, SCR_NOTIFICATION, &sntf) == 0)) {
2397 unsigned int err_mask;
2399 /* issue SET feature command to turn this on */
2400 err_mask = ata_dev_set_feature(dev,
2401 SETFEATURES_SATA_ENABLE, SATA_AN);
2403 ata_dev_printk(dev, KERN_ERR,
2404 "failed to enable ATAPI AN "
2405 "(err_mask=0x%x)\n", err_mask);
2407 dev->flags |= ATA_DFLAG_AN;
2408 atapi_an_string = ", ATAPI AN";
2412 if (ata_id_cdb_intr(dev->id)) {
2413 dev->flags |= ATA_DFLAG_CDB_INTR;
2414 cdb_intr_string = ", CDB intr";
2417 if (atapi_dmadir || atapi_id_dmadir(dev->id)) {
2418 dev->flags |= ATA_DFLAG_DMADIR;
2419 dma_dir_string = ", DMADIR";
2422 /* print device info to dmesg */
2423 if (ata_msg_drv(ap) && print_info)
2424 ata_dev_printk(dev, KERN_INFO,
2425 "ATAPI: %s, %s, max %s%s%s%s\n",
2427 ata_mode_string(xfer_mask),
2428 cdb_intr_string, atapi_an_string,
2432 /* determine max_sectors */
2433 dev->max_sectors = ATA_MAX_SECTORS;
2434 if (dev->flags & ATA_DFLAG_LBA48)
2435 dev->max_sectors = ATA_MAX_SECTORS_LBA48;
2437 if (!(dev->horkage & ATA_HORKAGE_IPM)) {
2438 if (ata_id_has_hipm(dev->id))
2439 dev->flags |= ATA_DFLAG_HIPM;
2440 if (ata_id_has_dipm(dev->id))
2441 dev->flags |= ATA_DFLAG_DIPM;
2444 /* Limit PATA drive on SATA cable bridge transfers to udma5,
2446 if (ata_dev_knobble(dev)) {
2447 if (ata_msg_drv(ap) && print_info)
2448 ata_dev_printk(dev, KERN_INFO,
2449 "applying bridge limits\n");
2450 dev->udma_mask &= ATA_UDMA5;
2451 dev->max_sectors = ATA_MAX_SECTORS;
2454 if ((dev->class == ATA_DEV_ATAPI) &&
2455 (atapi_command_packet_set(id) == TYPE_TAPE)) {
2456 dev->max_sectors = ATA_MAX_SECTORS_TAPE;
2457 dev->horkage |= ATA_HORKAGE_STUCK_ERR;
2460 if (dev->horkage & ATA_HORKAGE_MAX_SEC_128)
2461 dev->max_sectors = min_t(unsigned int, ATA_MAX_SECTORS_128,
2464 if (ata_dev_blacklisted(dev) & ATA_HORKAGE_IPM) {
2465 dev->horkage |= ATA_HORKAGE_IPM;
2467 /* reset link pm_policy for this port to no pm */
2468 ap->pm_policy = MAX_PERFORMANCE;
2471 if (ap->ops->dev_config)
2472 ap->ops->dev_config(dev);
2474 if (dev->horkage & ATA_HORKAGE_DIAGNOSTIC) {
2475 /* Let the user know. We don't want to disallow opens for
2476 rescue purposes, or in case the vendor is just a blithering
2477 idiot. Do this after the dev_config call as some controllers
2478 with buggy firmware may want to avoid reporting false device
2482 ata_dev_printk(dev, KERN_WARNING,
2483 "Drive reports diagnostics failure. This may indicate a drive\n");
2484 ata_dev_printk(dev, KERN_WARNING,
2485 "fault or invalid emulation. Contact drive vendor for information.\n");
2492 if (ata_msg_probe(ap))
2493 ata_dev_printk(dev, KERN_DEBUG,
2494 "%s: EXIT, err\n", __func__);
2499 * ata_cable_40wire - return 40 wire cable type
2502 * Helper method for drivers which want to hardwire 40 wire cable
2506 int ata_cable_40wire(struct ata_port *ap)
2508 return ATA_CBL_PATA40;
2512 * ata_cable_80wire - return 80 wire cable type
2515 * Helper method for drivers which want to hardwire 80 wire cable
2519 int ata_cable_80wire(struct ata_port *ap)
2521 return ATA_CBL_PATA80;
2525 * ata_cable_unknown - return unknown PATA cable.
2528 * Helper method for drivers which have no PATA cable detection.
2531 int ata_cable_unknown(struct ata_port *ap)
2533 return ATA_CBL_PATA_UNK;
2537 * ata_cable_ignore - return ignored PATA cable.
2540 * Helper method for drivers which don't use cable type to limit
2543 int ata_cable_ignore(struct ata_port *ap)
2545 return ATA_CBL_PATA_IGN;
2549 * ata_cable_sata - return SATA cable type
2552 * Helper method for drivers which have SATA cables
2555 int ata_cable_sata(struct ata_port *ap)
2557 return ATA_CBL_SATA;
2561 * ata_bus_probe - Reset and probe ATA bus
2564 * Master ATA bus probing function. Initiates a hardware-dependent
2565 * bus reset, then attempts to identify any devices found on
2569 * PCI/etc. bus probe sem.
2572 * Zero on success, negative errno otherwise.
2575 int ata_bus_probe(struct ata_port *ap)
2577 unsigned int classes[ATA_MAX_DEVICES];
2578 int tries[ATA_MAX_DEVICES];
2580 struct ata_device *dev;
2584 ata_link_for_each_dev(dev, &ap->link)
2585 tries[dev->devno] = ATA_PROBE_MAX_TRIES;
2588 ata_link_for_each_dev(dev, &ap->link) {
2589 /* If we issue an SRST then an ATA drive (not ATAPI)
2590 * may change configuration and be in PIO0 timing. If
2591 * we do a hard reset (or are coming from power on)
2592 * this is true for ATA or ATAPI. Until we've set a
2593 * suitable controller mode we should not touch the
2594 * bus as we may be talking too fast.
2596 dev->pio_mode = XFER_PIO_0;
2598 /* If the controller has a pio mode setup function
2599 * then use it to set the chipset to rights. Don't
2600 * touch the DMA setup as that will be dealt with when
2601 * configuring devices.
2603 if (ap->ops->set_piomode)
2604 ap->ops->set_piomode(ap, dev);
2607 /* reset and determine device classes */
2608 ap->ops->phy_reset(ap);
2610 ata_link_for_each_dev(dev, &ap->link) {
2611 if (!(ap->flags & ATA_FLAG_DISABLED) &&
2612 dev->class != ATA_DEV_UNKNOWN)
2613 classes[dev->devno] = dev->class;
2615 classes[dev->devno] = ATA_DEV_NONE;
2617 dev->class = ATA_DEV_UNKNOWN;
2622 /* read IDENTIFY page and configure devices. We have to do the identify
2623 specific sequence bass-ackwards so that PDIAG- is released by
2626 ata_link_for_each_dev_reverse(dev, &ap->link) {
2627 if (tries[dev->devno])
2628 dev->class = classes[dev->devno];
2630 if (!ata_dev_enabled(dev))
2633 rc = ata_dev_read_id(dev, &dev->class, ATA_READID_POSTRESET,
2639 /* Now ask for the cable type as PDIAG- should have been released */
2640 if (ap->ops->cable_detect)
2641 ap->cbl = ap->ops->cable_detect(ap);
2643 /* We may have SATA bridge glue hiding here irrespective of the
2644 reported cable types and sensed types */
2645 ata_link_for_each_dev(dev, &ap->link) {
2646 if (!ata_dev_enabled(dev))
2648 /* SATA drives indicate we have a bridge. We don't know which
2649 end of the link the bridge is which is a problem */
2650 if (ata_id_is_sata(dev->id))
2651 ap->cbl = ATA_CBL_SATA;
2654 /* After the identify sequence we can now set up the devices. We do
2655 this in the normal order so that the user doesn't get confused */
2657 ata_link_for_each_dev(dev, &ap->link) {
2658 if (!ata_dev_enabled(dev))
2661 ap->link.eh_context.i.flags |= ATA_EHI_PRINTINFO;
2662 rc = ata_dev_configure(dev);
2663 ap->link.eh_context.i.flags &= ~ATA_EHI_PRINTINFO;
2668 /* configure transfer mode */
2669 rc = ata_set_mode(&ap->link, &dev);
2673 ata_link_for_each_dev(dev, &ap->link)
2674 if (ata_dev_enabled(dev))
2677 /* no device present, disable port */
2678 ata_port_disable(ap);
2682 tries[dev->devno]--;
2686 /* eeek, something went very wrong, give up */
2687 tries[dev->devno] = 0;
2691 /* give it just one more chance */
2692 tries[dev->devno] = min(tries[dev->devno], 1);
2694 if (tries[dev->devno] == 1) {
2695 /* This is the last chance, better to slow
2696 * down than lose it.
2698 sata_down_spd_limit(&ap->link);
2699 ata_down_xfermask_limit(dev, ATA_DNXFER_PIO);
2703 if (!tries[dev->devno])
2704 ata_dev_disable(dev);
2710 * ata_port_probe - Mark port as enabled
2711 * @ap: Port for which we indicate enablement
2713 * Modify @ap data structure such that the system
2714 * thinks that the entire port is enabled.
2716 * LOCKING: host lock, or some other form of
2720 void ata_port_probe(struct ata_port *ap)
2722 ap->flags &= ~ATA_FLAG_DISABLED;
2726 * sata_print_link_status - Print SATA link status
2727 * @link: SATA link to printk link status about
2729 * This function prints link speed and status of a SATA link.
2734 static void sata_print_link_status(struct ata_link *link)
2736 u32 sstatus, scontrol, tmp;
2738 if (sata_scr_read(link, SCR_STATUS, &sstatus))
2740 sata_scr_read(link, SCR_CONTROL, &scontrol);
2742 if (ata_phys_link_online(link)) {
2743 tmp = (sstatus >> 4) & 0xf;
2744 ata_link_printk(link, KERN_INFO,
2745 "SATA link up %s (SStatus %X SControl %X)\n",
2746 sata_spd_string(tmp), sstatus, scontrol);
2748 ata_link_printk(link, KERN_INFO,
2749 "SATA link down (SStatus %X SControl %X)\n",
2755 * ata_dev_pair - return other device on cable
2758 * Obtain the other device on the same cable, or if none is
2759 * present NULL is returned
2762 struct ata_device *ata_dev_pair(struct ata_device *adev)
2764 struct ata_link *link = adev->link;
2765 struct ata_device *pair = &link->device[1 - adev->devno];
2766 if (!ata_dev_enabled(pair))
2772 * ata_port_disable - Disable port.
2773 * @ap: Port to be disabled.
2775 * Modify @ap data structure such that the system
2776 * thinks that the entire port is disabled, and should
2777 * never attempt to probe or communicate with devices
2780 * LOCKING: host lock, or some other form of
2784 void ata_port_disable(struct ata_port *ap)
2786 ap->link.device[0].class = ATA_DEV_NONE;
2787 ap->link.device[1].class = ATA_DEV_NONE;
2788 ap->flags |= ATA_FLAG_DISABLED;
2792 * sata_down_spd_limit - adjust SATA spd limit downward
2793 * @link: Link to adjust SATA spd limit for
2795 * Adjust SATA spd limit of @link downward. Note that this
2796 * function only adjusts the limit. The change must be applied
2797 * using sata_set_spd().
2800 * Inherited from caller.
2803 * 0 on success, negative errno on failure
2805 int sata_down_spd_limit(struct ata_link *link)
2807 u32 sstatus, spd, mask;
2810 if (!sata_scr_valid(link))
2813 /* If SCR can be read, use it to determine the current SPD.
2814 * If not, use cached value in link->sata_spd.
2816 rc = sata_scr_read(link, SCR_STATUS, &sstatus);
2818 spd = (sstatus >> 4) & 0xf;
2820 spd = link->sata_spd;
2822 mask = link->sata_spd_limit;
2826 /* unconditionally mask off the highest bit */
2827 highbit = fls(mask) - 1;
2828 mask &= ~(1 << highbit);
2830 /* Mask off all speeds higher than or equal to the current
2831 * one. Force 1.5Gbps if current SPD is not available.
2834 mask &= (1 << (spd - 1)) - 1;
2838 /* were we already at the bottom? */
2842 link->sata_spd_limit = mask;
2844 ata_link_printk(link, KERN_WARNING, "limiting SATA link speed to %s\n",
2845 sata_spd_string(fls(mask)));
2850 static int __sata_set_spd_needed(struct ata_link *link, u32 *scontrol)
2852 struct ata_link *host_link = &link->ap->link;
2853 u32 limit, target, spd;
2855 limit = link->sata_spd_limit;
2857 /* Don't configure downstream link faster than upstream link.
2858 * It doesn't speed up anything and some PMPs choke on such
2861 if (!ata_is_host_link(link) && host_link->sata_spd)
2862 limit &= (1 << host_link->sata_spd) - 1;
2864 if (limit == UINT_MAX)
2867 target = fls(limit);
2869 spd = (*scontrol >> 4) & 0xf;
2870 *scontrol = (*scontrol & ~0xf0) | ((target & 0xf) << 4);
2872 return spd != target;
2876 * sata_set_spd_needed - is SATA spd configuration needed
2877 * @link: Link in question
2879 * Test whether the spd limit in SControl matches
2880 * @link->sata_spd_limit. This function is used to determine
2881 * whether hardreset is necessary to apply SATA spd
2885 * Inherited from caller.
2888 * 1 if SATA spd configuration is needed, 0 otherwise.
2890 static int sata_set_spd_needed(struct ata_link *link)
2894 if (sata_scr_read(link, SCR_CONTROL, &scontrol))
2897 return __sata_set_spd_needed(link, &scontrol);
2901 * sata_set_spd - set SATA spd according to spd limit
2902 * @link: Link to set SATA spd for
2904 * Set SATA spd of @link according to sata_spd_limit.
2907 * Inherited from caller.
2910 * 0 if spd doesn't need to be changed, 1 if spd has been
2911 * changed. Negative errno if SCR registers are inaccessible.
2913 int sata_set_spd(struct ata_link *link)
2918 if ((rc = sata_scr_read(link, SCR_CONTROL, &scontrol)))
2921 if (!__sata_set_spd_needed(link, &scontrol))
2924 if ((rc = sata_scr_write(link, SCR_CONTROL, scontrol)))
2931 * This mode timing computation functionality is ported over from
2932 * drivers/ide/ide-timing.h and was originally written by Vojtech Pavlik
2935 * PIO 0-4, MWDMA 0-2 and UDMA 0-6 timings (in nanoseconds).
2936 * These were taken from ATA/ATAPI-6 standard, rev 0a, except
2937 * for UDMA6, which is currently supported only by Maxtor drives.
2939 * For PIO 5/6 MWDMA 3/4 see the CFA specification 3.0.
2942 static const struct ata_timing ata_timing[] = {
2943 /* { XFER_PIO_SLOW, 120, 290, 240, 960, 290, 240, 960, 0 }, */
2944 { XFER_PIO_0, 70, 290, 240, 600, 165, 150, 600, 0 },
2945 { XFER_PIO_1, 50, 290, 93, 383, 125, 100, 383, 0 },
2946 { XFER_PIO_2, 30, 290, 40, 330, 100, 90, 240, 0 },
2947 { XFER_PIO_3, 30, 80, 70, 180, 80, 70, 180, 0 },
2948 { XFER_PIO_4, 25, 70, 25, 120, 70, 25, 120, 0 },
2949 { XFER_PIO_5, 15, 65, 25, 100, 65, 25, 100, 0 },
2950 { XFER_PIO_6, 10, 55, 20, 80, 55, 20, 80, 0 },
2952 { XFER_SW_DMA_0, 120, 0, 0, 0, 480, 480, 960, 0 },
2953 { XFER_SW_DMA_1, 90, 0, 0, 0, 240, 240, 480, 0 },
2954 { XFER_SW_DMA_2, 60, 0, 0, 0, 120, 120, 240, 0 },
2956 { XFER_MW_DMA_0, 60, 0, 0, 0, 215, 215, 480, 0 },
2957 { XFER_MW_DMA_1, 45, 0, 0, 0, 80, 50, 150, 0 },
2958 { XFER_MW_DMA_2, 25, 0, 0, 0, 70, 25, 120, 0 },
2959 { XFER_MW_DMA_3, 25, 0, 0, 0, 65, 25, 100, 0 },
2960 { XFER_MW_DMA_4, 25, 0, 0, 0, 55, 20, 80, 0 },
2962 /* { XFER_UDMA_SLOW, 0, 0, 0, 0, 0, 0, 0, 150 }, */
2963 { XFER_UDMA_0, 0, 0, 0, 0, 0, 0, 0, 120 },
2964 { XFER_UDMA_1, 0, 0, 0, 0, 0, 0, 0, 80 },
2965 { XFER_UDMA_2, 0, 0, 0, 0, 0, 0, 0, 60 },
2966 { XFER_UDMA_3, 0, 0, 0, 0, 0, 0, 0, 45 },
2967 { XFER_UDMA_4, 0, 0, 0, 0, 0, 0, 0, 30 },
2968 { XFER_UDMA_5, 0, 0, 0, 0, 0, 0, 0, 20 },
2969 { XFER_UDMA_6, 0, 0, 0, 0, 0, 0, 0, 15 },
2974 #define ENOUGH(v, unit) (((v)-1)/(unit)+1)
2975 #define EZ(v, unit) ((v)?ENOUGH(v, unit):0)
2977 static void ata_timing_quantize(const struct ata_timing *t, struct ata_timing *q, int T, int UT)
2979 q->setup = EZ(t->setup * 1000, T);
2980 q->act8b = EZ(t->act8b * 1000, T);
2981 q->rec8b = EZ(t->rec8b * 1000, T);
2982 q->cyc8b = EZ(t->cyc8b * 1000, T);
2983 q->active = EZ(t->active * 1000, T);
2984 q->recover = EZ(t->recover * 1000, T);
2985 q->cycle = EZ(t->cycle * 1000, T);
2986 q->udma = EZ(t->udma * 1000, UT);
2989 void ata_timing_merge(const struct ata_timing *a, const struct ata_timing *b,
2990 struct ata_timing *m, unsigned int what)
2992 if (what & ATA_TIMING_SETUP ) m->setup = max(a->setup, b->setup);
2993 if (what & ATA_TIMING_ACT8B ) m->act8b = max(a->act8b, b->act8b);
2994 if (what & ATA_TIMING_REC8B ) m->rec8b = max(a->rec8b, b->rec8b);
2995 if (what & ATA_TIMING_CYC8B ) m->cyc8b = max(a->cyc8b, b->cyc8b);
2996 if (what & ATA_TIMING_ACTIVE ) m->active = max(a->active, b->active);
2997 if (what & ATA_TIMING_RECOVER) m->recover = max(a->recover, b->recover);
2998 if (what & ATA_TIMING_CYCLE ) m->cycle = max(a->cycle, b->cycle);
2999 if (what & ATA_TIMING_UDMA ) m->udma = max(a->udma, b->udma);
3002 const struct ata_timing *ata_timing_find_mode(u8 xfer_mode)
3004 const struct ata_timing *t = ata_timing;
3006 while (xfer_mode > t->mode)
3009 if (xfer_mode == t->mode)
3014 int ata_timing_compute(struct ata_device *adev, unsigned short speed,
3015 struct ata_timing *t, int T, int UT)
3017 const struct ata_timing *s;
3018 struct ata_timing p;
3024 if (!(s = ata_timing_find_mode(speed)))
3027 memcpy(t, s, sizeof(*s));
3030 * If the drive is an EIDE drive, it can tell us it needs extended
3031 * PIO/MW_DMA cycle timing.
3034 if (adev->id[ATA_ID_FIELD_VALID] & 2) { /* EIDE drive */
3035 memset(&p, 0, sizeof(p));
3036 if (speed >= XFER_PIO_0 && speed <= XFER_SW_DMA_0) {
3037 if (speed <= XFER_PIO_2) p.cycle = p.cyc8b = adev->id[ATA_ID_EIDE_PIO];
3038 else p.cycle = p.cyc8b = adev->id[ATA_ID_EIDE_PIO_IORDY];
3039 } else if (speed >= XFER_MW_DMA_0 && speed <= XFER_MW_DMA_2) {
3040 p.cycle = adev->id[ATA_ID_EIDE_DMA_MIN];
3042 ata_timing_merge(&p, t, t, ATA_TIMING_CYCLE | ATA_TIMING_CYC8B);
3046 * Convert the timing to bus clock counts.
3049 ata_timing_quantize(t, t, T, UT);
3052 * Even in DMA/UDMA modes we still use PIO access for IDENTIFY,
3053 * S.M.A.R.T * and some other commands. We have to ensure that the
3054 * DMA cycle timing is slower/equal than the fastest PIO timing.
3057 if (speed > XFER_PIO_6) {
3058 ata_timing_compute(adev, adev->pio_mode, &p, T, UT);
3059 ata_timing_merge(&p, t, t, ATA_TIMING_ALL);
3063 * Lengthen active & recovery time so that cycle time is correct.
3066 if (t->act8b + t->rec8b < t->cyc8b) {
3067 t->act8b += (t->cyc8b - (t->act8b + t->rec8b)) / 2;
3068 t->rec8b = t->cyc8b - t->act8b;
3071 if (t->active + t->recover < t->cycle) {
3072 t->active += (t->cycle - (t->active + t->recover)) / 2;
3073 t->recover = t->cycle - t->active;
3076 /* In a few cases quantisation may produce enough errors to
3077 leave t->cycle too low for the sum of active and recovery
3078 if so we must correct this */
3079 if (t->active + t->recover > t->cycle)
3080 t->cycle = t->active + t->recover;
3086 * ata_timing_cycle2mode - find xfer mode for the specified cycle duration
3087 * @xfer_shift: ATA_SHIFT_* value for transfer type to examine.
3088 * @cycle: cycle duration in ns
3090 * Return matching xfer mode for @cycle. The returned mode is of
3091 * the transfer type specified by @xfer_shift. If @cycle is too
3092 * slow for @xfer_shift, 0xff is returned. If @cycle is faster
3093 * than the fastest known mode, the fasted mode is returned.
3099 * Matching xfer_mode, 0xff if no match found.
3101 u8 ata_timing_cycle2mode(unsigned int xfer_shift, int cycle)
3103 u8 base_mode = 0xff, last_mode = 0xff;
3104 const struct ata_xfer_ent *ent;
3105 const struct ata_timing *t;
3107 for (ent = ata_xfer_tbl; ent->shift >= 0; ent++)
3108 if (ent->shift == xfer_shift)
3109 base_mode = ent->base;
3111 for (t = ata_timing_find_mode(base_mode);
3112 t && ata_xfer_mode2shift(t->mode) == xfer_shift; t++) {
3113 unsigned short this_cycle;
3115 switch (xfer_shift) {
3117 case ATA_SHIFT_MWDMA:
3118 this_cycle = t->cycle;
3120 case ATA_SHIFT_UDMA:
3121 this_cycle = t->udma;
3127 if (cycle > this_cycle)
3130 last_mode = t->mode;
3137 * ata_down_xfermask_limit - adjust dev xfer masks downward
3138 * @dev: Device to adjust xfer masks
3139 * @sel: ATA_DNXFER_* selector
3141 * Adjust xfer masks of @dev downward. Note that this function
3142 * does not apply the change. Invoking ata_set_mode() afterwards
3143 * will apply the limit.
3146 * Inherited from caller.
3149 * 0 on success, negative errno on failure
3151 int ata_down_xfermask_limit(struct ata_device *dev, unsigned int sel)
3154 unsigned long orig_mask, xfer_mask;
3155 unsigned long pio_mask, mwdma_mask, udma_mask;
3158 quiet = !!(sel & ATA_DNXFER_QUIET);
3159 sel &= ~ATA_DNXFER_QUIET;
3161 xfer_mask = orig_mask = ata_pack_xfermask(dev->pio_mask,
3164 ata_unpack_xfermask(xfer_mask, &pio_mask, &mwdma_mask, &udma_mask);
3167 case ATA_DNXFER_PIO:
3168 highbit = fls(pio_mask) - 1;
3169 pio_mask &= ~(1 << highbit);
3172 case ATA_DNXFER_DMA:
3174 highbit = fls(udma_mask) - 1;
3175 udma_mask &= ~(1 << highbit);
3178 } else if (mwdma_mask) {
3179 highbit = fls(mwdma_mask) - 1;
3180 mwdma_mask &= ~(1 << highbit);
3186 case ATA_DNXFER_40C:
3187 udma_mask &= ATA_UDMA_MASK_40C;
3190 case ATA_DNXFER_FORCE_PIO0:
3192 case ATA_DNXFER_FORCE_PIO:
3201 xfer_mask &= ata_pack_xfermask(pio_mask, mwdma_mask, udma_mask);
3203 if (!(xfer_mask & ATA_MASK_PIO) || xfer_mask == orig_mask)
3207 if (xfer_mask & (ATA_MASK_MWDMA | ATA_MASK_UDMA))
3208 snprintf(buf, sizeof(buf), "%s:%s",
3209 ata_mode_string(xfer_mask),
3210 ata_mode_string(xfer_mask & ATA_MASK_PIO));
3212 snprintf(buf, sizeof(buf), "%s",
3213 ata_mode_string(xfer_mask));
3215 ata_dev_printk(dev, KERN_WARNING,
3216 "limiting speed to %s\n", buf);
3219 ata_unpack_xfermask(xfer_mask, &dev->pio_mask, &dev->mwdma_mask,
3225 static int ata_dev_set_mode(struct ata_device *dev)
3227 struct ata_eh_context *ehc = &dev->link->eh_context;
3228 const char *dev_err_whine = "";
3229 int ign_dev_err = 0;
3230 unsigned int err_mask;
3233 dev->flags &= ~ATA_DFLAG_PIO;
3234 if (dev->xfer_shift == ATA_SHIFT_PIO)
3235 dev->flags |= ATA_DFLAG_PIO;
3237 err_mask = ata_dev_set_xfermode(dev);
3239 if (err_mask & ~AC_ERR_DEV)
3243 ehc->i.flags |= ATA_EHI_POST_SETMODE;
3244 rc = ata_dev_revalidate(dev, ATA_DEV_UNKNOWN, 0);
3245 ehc->i.flags &= ~ATA_EHI_POST_SETMODE;
3249 if (dev->xfer_shift == ATA_SHIFT_PIO) {
3250 /* Old CFA may refuse this command, which is just fine */
3251 if (ata_id_is_cfa(dev->id))
3253 /* Catch several broken garbage emulations plus some pre
3255 if (ata_id_major_version(dev->id) == 0 &&
3256 dev->pio_mode <= XFER_PIO_2)
3258 /* Some very old devices and some bad newer ones fail
3259 any kind of SET_XFERMODE request but support PIO0-2
3260 timings and no IORDY */
3261 if (!ata_id_has_iordy(dev->id) && dev->pio_mode <= XFER_PIO_2)
3264 /* Early MWDMA devices do DMA but don't allow DMA mode setting.
3265 Don't fail an MWDMA0 set IFF the device indicates it is in MWDMA0 */
3266 if (dev->xfer_shift == ATA_SHIFT_MWDMA &&
3267 dev->dma_mode == XFER_MW_DMA_0 &&
3268 (dev->id[63] >> 8) & 1)
3271 /* if the device is actually configured correctly, ignore dev err */
3272 if (dev->xfer_mode == ata_xfer_mask2mode(ata_id_xfermask(dev->id)))
3275 if (err_mask & AC_ERR_DEV) {
3279 dev_err_whine = " (device error ignored)";
3282 DPRINTK("xfer_shift=%u, xfer_mode=0x%x\n",
3283 dev->xfer_shift, (int)dev->xfer_mode);
3285 ata_dev_printk(dev, KERN_INFO, "configured for %s%s\n",
3286 ata_mode_string(ata_xfer_mode2mask(dev->xfer_mode)),
3292 ata_dev_printk(dev, KERN_ERR, "failed to set xfermode "
3293 "(err_mask=0x%x)\n", err_mask);
3298 * ata_do_set_mode - Program timings and issue SET FEATURES - XFER
3299 * @link: link on which timings will be programmed
3300 * @r_failed_dev: out parameter for failed device
3302 * Standard implementation of the function used to tune and set
3303 * ATA device disk transfer mode (PIO3, UDMA6, etc.). If
3304 * ata_dev_set_mode() fails, pointer to the failing device is
3305 * returned in @r_failed_dev.
3308 * PCI/etc. bus probe sem.
3311 * 0 on success, negative errno otherwise
3314 int ata_do_set_mode(struct ata_link *link, struct ata_device **r_failed_dev)
3316 struct ata_port *ap = link->ap;
3317 struct ata_device *dev;
3318 int rc = 0, used_dma = 0, found = 0;
3320 /* step 1: calculate xfer_mask */
3321 ata_link_for_each_dev(dev, link) {
3322 unsigned long pio_mask, dma_mask;
3323 unsigned int mode_mask;
3325 if (!ata_dev_enabled(dev))
3328 mode_mask = ATA_DMA_MASK_ATA;
3329 if (dev->class == ATA_DEV_ATAPI)
3330 mode_mask = ATA_DMA_MASK_ATAPI;
3331 else if (ata_id_is_cfa(dev->id))
3332 mode_mask = ATA_DMA_MASK_CFA;
3334 ata_dev_xfermask(dev);
3335 ata_force_xfermask(dev);
3337 pio_mask = ata_pack_xfermask(dev->pio_mask, 0, 0);
3338 dma_mask = ata_pack_xfermask(0, dev->mwdma_mask, dev->udma_mask);
3340 if (libata_dma_mask & mode_mask)
3341 dma_mask = ata_pack_xfermask(0, dev->mwdma_mask, dev->udma_mask);
3345 dev->pio_mode = ata_xfer_mask2mode(pio_mask);
3346 dev->dma_mode = ata_xfer_mask2mode(dma_mask);
3349 if (ata_dma_enabled(dev))
3355 /* step 2: always set host PIO timings */
3356 ata_link_for_each_dev(dev, link) {
3357 if (!ata_dev_enabled(dev))
3360 if (dev->pio_mode == 0xff) {
3361 ata_dev_printk(dev, KERN_WARNING, "no PIO support\n");
3366 dev->xfer_mode = dev->pio_mode;
3367 dev->xfer_shift = ATA_SHIFT_PIO;
3368 if (ap->ops->set_piomode)
3369 ap->ops->set_piomode(ap, dev);
3372 /* step 3: set host DMA timings */
3373 ata_link_for_each_dev(dev, link) {
3374 if (!ata_dev_enabled(dev) || !ata_dma_enabled(dev))
3377 dev->xfer_mode = dev->dma_mode;
3378 dev->xfer_shift = ata_xfer_mode2shift(dev->dma_mode);
3379 if (ap->ops->set_dmamode)
3380 ap->ops->set_dmamode(ap, dev);
3383 /* step 4: update devices' xfer mode */
3384 ata_link_for_each_dev(dev, link) {
3385 /* don't update suspended devices' xfer mode */
3386 if (!ata_dev_enabled(dev))
3389 rc = ata_dev_set_mode(dev);
3394 /* Record simplex status. If we selected DMA then the other
3395 * host channels are not permitted to do so.
3397 if (used_dma && (ap->host->flags & ATA_HOST_SIMPLEX))
3398 ap->host->simplex_claimed = ap;
3402 *r_failed_dev = dev;
3407 * ata_wait_ready - wait for link to become ready
3408 * @link: link to be waited on
3409 * @deadline: deadline jiffies for the operation
3410 * @check_ready: callback to check link readiness
3412 * Wait for @link to become ready. @check_ready should return
3413 * positive number if @link is ready, 0 if it isn't, -ENODEV if
3414 * link doesn't seem to be occupied, other errno for other error
3417 * Transient -ENODEV conditions are allowed for
3418 * ATA_TMOUT_FF_WAIT.
3424 * 0 if @linke is ready before @deadline; otherwise, -errno.
3426 int ata_wait_ready(struct ata_link *link, unsigned long deadline,
3427 int (*check_ready)(struct ata_link *link))
3429 unsigned long start = jiffies;
3430 unsigned long nodev_deadline = ata_deadline(start, ATA_TMOUT_FF_WAIT);
3433 /* Slave readiness can't be tested separately from master. On
3434 * M/S emulation configuration, this function should be called
3435 * only on the master and it will handle both master and slave.
3437 WARN_ON(link == link->ap->slave_link);
3439 if (time_after(nodev_deadline, deadline))
3440 nodev_deadline = deadline;
3443 unsigned long now = jiffies;
3446 ready = tmp = check_ready(link);
3450 /* -ENODEV could be transient. Ignore -ENODEV if link
3451 * is online. Also, some SATA devices take a long
3452 * time to clear 0xff after reset. For example,
3453 * HHD424020F7SV00 iVDR needs >= 800ms while Quantum
3454 * GoVault needs even more than that. Wait for
3455 * ATA_TMOUT_FF_WAIT on -ENODEV if link isn't offline.
3457 * Note that some PATA controllers (pata_ali) explode
3458 * if status register is read more than once when
3459 * there's no device attached.
3461 if (ready == -ENODEV) {
3462 if (ata_link_online(link))
3464 else if ((link->ap->flags & ATA_FLAG_SATA) &&
3465 !ata_link_offline(link) &&
3466 time_before(now, nodev_deadline))
3472 if (time_after(now, deadline))
3475 if (!warned && time_after(now, start + 5 * HZ) &&
3476 (deadline - now > 3 * HZ)) {
3477 ata_link_printk(link, KERN_WARNING,
3478 "link is slow to respond, please be patient "
3479 "(ready=%d)\n", tmp);
3488 * ata_wait_after_reset - wait for link to become ready after reset
3489 * @link: link to be waited on
3490 * @deadline: deadline jiffies for the operation
3491 * @check_ready: callback to check link readiness
3493 * Wait for @link to become ready after reset.
3499 * 0 if @linke is ready before @deadline; otherwise, -errno.
3501 int ata_wait_after_reset(struct ata_link *link, unsigned long deadline,
3502 int (*check_ready)(struct ata_link *link))
3504 msleep(ATA_WAIT_AFTER_RESET);
3506 return ata_wait_ready(link, deadline, check_ready);
3510 * sata_link_debounce - debounce SATA phy status
3511 * @link: ATA link to debounce SATA phy status for
3512 * @params: timing parameters { interval, duratinon, timeout } in msec
3513 * @deadline: deadline jiffies for the operation
3515 * Make sure SStatus of @link reaches stable state, determined by
3516 * holding the same value where DET is not 1 for @duration polled
3517 * every @interval, before @timeout. Timeout constraints the
3518 * beginning of the stable state. Because DET gets stuck at 1 on
3519 * some controllers after hot unplugging, this functions waits
3520 * until timeout then returns 0 if DET is stable at 1.
3522 * @timeout is further limited by @deadline. The sooner of the
3526 * Kernel thread context (may sleep)
3529 * 0 on success, -errno on failure.
3531 int sata_link_debounce(struct ata_link *link, const unsigned long *params,
3532 unsigned long deadline)
3534 unsigned long interval = params[0];
3535 unsigned long duration = params[1];
3536 unsigned long last_jiffies, t;
3540 t = ata_deadline(jiffies, params[2]);
3541 if (time_before(t, deadline))
3544 if ((rc = sata_scr_read(link, SCR_STATUS, &cur)))
3549 last_jiffies = jiffies;
3553 if ((rc = sata_scr_read(link, SCR_STATUS, &cur)))
3559 if (cur == 1 && time_before(jiffies, deadline))
3561 if (time_after(jiffies,
3562 ata_deadline(last_jiffies, duration)))
3567 /* unstable, start over */
3569 last_jiffies = jiffies;
3571 /* Check deadline. If debouncing failed, return
3572 * -EPIPE to tell upper layer to lower link speed.
3574 if (time_after(jiffies, deadline))
3580 * sata_link_resume - resume SATA link
3581 * @link: ATA link to resume SATA
3582 * @params: timing parameters { interval, duratinon, timeout } in msec
3583 * @deadline: deadline jiffies for the operation
3585 * Resume SATA phy @link and debounce it.
3588 * Kernel thread context (may sleep)
3591 * 0 on success, -errno on failure.
3593 int sata_link_resume(struct ata_link *link, const unsigned long *params,
3594 unsigned long deadline)
3596 u32 scontrol, serror;
3599 if ((rc = sata_scr_read(link, SCR_CONTROL, &scontrol)))
3602 scontrol = (scontrol & 0x0f0) | 0x300;
3604 if ((rc = sata_scr_write(link, SCR_CONTROL, scontrol)))
3607 /* Some PHYs react badly if SStatus is pounded immediately
3608 * after resuming. Delay 200ms before debouncing.
3612 if ((rc = sata_link_debounce(link, params, deadline)))
3615 /* clear SError, some PHYs require this even for SRST to work */
3616 if (!(rc = sata_scr_read(link, SCR_ERROR, &serror)))
3617 rc = sata_scr_write(link, SCR_ERROR, serror);
3619 return rc != -EINVAL ? rc : 0;
3623 * ata_std_prereset - prepare for reset
3624 * @link: ATA link to be reset
3625 * @deadline: deadline jiffies for the operation
3627 * @link is about to be reset. Initialize it. Failure from
3628 * prereset makes libata abort whole reset sequence and give up
3629 * that port, so prereset should be best-effort. It does its
3630 * best to prepare for reset sequence but if things go wrong, it
3631 * should just whine, not fail.
3634 * Kernel thread context (may sleep)
3637 * 0 on success, -errno otherwise.
3639 int ata_std_prereset(struct ata_link *link, unsigned long deadline)
3641 struct ata_port *ap = link->ap;
3642 struct ata_eh_context *ehc = &link->eh_context;
3643 const unsigned long *timing = sata_ehc_deb_timing(ehc);
3646 /* if we're about to do hardreset, nothing more to do */
3647 if (ehc->i.action & ATA_EH_HARDRESET)
3650 /* if SATA, resume link */
3651 if (ap->flags & ATA_FLAG_SATA) {
3652 rc = sata_link_resume(link, timing, deadline);
3653 /* whine about phy resume failure but proceed */
3654 if (rc && rc != -EOPNOTSUPP)
3655 ata_link_printk(link, KERN_WARNING, "failed to resume "
3656 "link for reset (errno=%d)\n", rc);
3659 /* no point in trying softreset on offline link */
3660 if (ata_phys_link_offline(link))
3661 ehc->i.action &= ~ATA_EH_SOFTRESET;
3667 * sata_link_hardreset - reset link via SATA phy reset
3668 * @link: link to reset
3669 * @timing: timing parameters { interval, duratinon, timeout } in msec
3670 * @deadline: deadline jiffies for the operation
3671 * @online: optional out parameter indicating link onlineness
3672 * @check_ready: optional callback to check link readiness
3674 * SATA phy-reset @link using DET bits of SControl register.
3675 * After hardreset, link readiness is waited upon using
3676 * ata_wait_ready() if @check_ready is specified. LLDs are
3677 * allowed to not specify @check_ready and wait itself after this
3678 * function returns. Device classification is LLD's
3681 * *@online is set to one iff reset succeeded and @link is online
3685 * Kernel thread context (may sleep)
3688 * 0 on success, -errno otherwise.
3690 int sata_link_hardreset(struct ata_link *link, const unsigned long *timing,
3691 unsigned long deadline,
3692 bool *online, int (*check_ready)(struct ata_link *))
3702 if (sata_set_spd_needed(link)) {
3703 /* SATA spec says nothing about how to reconfigure
3704 * spd. To be on the safe side, turn off phy during
3705 * reconfiguration. This works for at least ICH7 AHCI
3708 if ((rc = sata_scr_read(link, SCR_CONTROL, &scontrol)))
3711 scontrol = (scontrol & 0x0f0) | 0x304;
3713 if ((rc = sata_scr_write(link, SCR_CONTROL, scontrol)))
3719 /* issue phy wake/reset */
3720 if ((rc = sata_scr_read(link, SCR_CONTROL, &scontrol)))
3723 scontrol = (scontrol & 0x0f0) | 0x301;
3725 if ((rc = sata_scr_write_flush(link, SCR_CONTROL, scontrol)))
3728 /* Couldn't find anything in SATA I/II specs, but AHCI-1.1
3729 * 10.4.2 says at least 1 ms.
3733 /* bring link back */
3734 rc = sata_link_resume(link, timing, deadline);
3737 /* if link is offline nothing more to do */
3738 if (ata_phys_link_offline(link))
3741 /* Link is online. From this point, -ENODEV too is an error. */
3745 if (sata_pmp_supported(link->ap) && ata_is_host_link(link)) {
3746 /* If PMP is supported, we have to do follow-up SRST.
3747 * Some PMPs don't send D2H Reg FIS after hardreset if
3748 * the first port is empty. Wait only for
3749 * ATA_TMOUT_PMP_SRST_WAIT.
3752 unsigned long pmp_deadline;
3754 pmp_deadline = ata_deadline(jiffies,
3755 ATA_TMOUT_PMP_SRST_WAIT);
3756 if (time_after(pmp_deadline, deadline))
3757 pmp_deadline = deadline;
3758 ata_wait_ready(link, pmp_deadline, check_ready);
3766 rc = ata_wait_ready(link, deadline, check_ready);
3768 if (rc && rc != -EAGAIN) {
3769 /* online is set iff link is online && reset succeeded */
3772 ata_link_printk(link, KERN_ERR,
3773 "COMRESET failed (errno=%d)\n", rc);
3775 DPRINTK("EXIT, rc=%d\n", rc);
3780 * sata_std_hardreset - COMRESET w/o waiting or classification
3781 * @link: link to reset
3782 * @class: resulting class of attached device
3783 * @deadline: deadline jiffies for the operation
3785 * Standard SATA COMRESET w/o waiting or classification.
3788 * Kernel thread context (may sleep)
3791 * 0 if link offline, -EAGAIN if link online, -errno on errors.
3793 int sata_std_hardreset(struct ata_link *link, unsigned int *class,
3794 unsigned long deadline)
3796 const unsigned long *timing = sata_ehc_deb_timing(&link->eh_context);
3801 rc = sata_link_hardreset(link, timing, deadline, &online, NULL);
3802 return online ? -EAGAIN : rc;
3806 * ata_std_postreset - standard postreset callback
3807 * @link: the target ata_link
3808 * @classes: classes of attached devices
3810 * This function is invoked after a successful reset. Note that
3811 * the device might have been reset more than once using
3812 * different reset methods before postreset is invoked.
3815 * Kernel thread context (may sleep)
3817 void ata_std_postreset(struct ata_link *link, unsigned int *classes)
3823 /* reset complete, clear SError */
3824 if (!sata_scr_read(link, SCR_ERROR, &serror))
3825 sata_scr_write(link, SCR_ERROR, serror);
3827 /* print link status */
3828 sata_print_link_status(link);
3834 * ata_dev_same_device - Determine whether new ID matches configured device
3835 * @dev: device to compare against
3836 * @new_class: class of the new device
3837 * @new_id: IDENTIFY page of the new device
3839 * Compare @new_class and @new_id against @dev and determine
3840 * whether @dev is the device indicated by @new_class and
3847 * 1 if @dev matches @new_class and @new_id, 0 otherwise.
3849 static int ata_dev_same_device(struct ata_device *dev, unsigned int new_class,
3852 const u16 *old_id = dev->id;
3853 unsigned char model[2][ATA_ID_PROD_LEN + 1];
3854 unsigned char serial[2][ATA_ID_SERNO_LEN + 1];
3856 if (dev->class != new_class) {
3857 ata_dev_printk(dev, KERN_INFO, "class mismatch %d != %d\n",
3858 dev->class, new_class);
3862 ata_id_c_string(old_id, model[0], ATA_ID_PROD, sizeof(model[0]));
3863 ata_id_c_string(new_id, model[1], ATA_ID_PROD, sizeof(model[1]));
3864 ata_id_c_string(old_id, serial[0], ATA_ID_SERNO, sizeof(serial[0]));
3865 ata_id_c_string(new_id, serial[1], ATA_ID_SERNO, sizeof(serial[1]));
3867 if (strcmp(model[0], model[1])) {
3868 ata_dev_printk(dev, KERN_INFO, "model number mismatch "
3869 "'%s' != '%s'\n", model[0], model[1]);
3873 if (strcmp(serial[0], serial[1])) {
3874 ata_dev_printk(dev, KERN_INFO, "serial number mismatch "
3875 "'%s' != '%s'\n", serial[0], serial[1]);
3883 * ata_dev_reread_id - Re-read IDENTIFY data
3884 * @dev: target ATA device
3885 * @readid_flags: read ID flags
3887 * Re-read IDENTIFY page and make sure @dev is still attached to
3891 * Kernel thread context (may sleep)
3894 * 0 on success, negative errno otherwise
3896 int ata_dev_reread_id(struct ata_device *dev, unsigned int readid_flags)
3898 unsigned int class = dev->class;
3899 u16 *id = (void *)dev->link->ap->sector_buf;
3903 rc = ata_dev_read_id(dev, &class, readid_flags, id);
3907 /* is the device still there? */
3908 if (!ata_dev_same_device(dev, class, id))
3911 memcpy(dev->id, id, sizeof(id[0]) * ATA_ID_WORDS);
3916 * ata_dev_revalidate - Revalidate ATA device
3917 * @dev: device to revalidate
3918 * @new_class: new class code
3919 * @readid_flags: read ID flags
3921 * Re-read IDENTIFY page, make sure @dev is still attached to the
3922 * port and reconfigure it according to the new IDENTIFY page.
3925 * Kernel thread context (may sleep)
3928 * 0 on success, negative errno otherwise
3930 int ata_dev_revalidate(struct ata_device *dev, unsigned int new_class,
3931 unsigned int readid_flags)
3933 u64 n_sectors = dev->n_sectors;
3936 if (!ata_dev_enabled(dev))
3939 /* fail early if !ATA && !ATAPI to avoid issuing [P]IDENTIFY to PMP */
3940 if (ata_class_enabled(new_class) &&
3941 new_class != ATA_DEV_ATA && new_class != ATA_DEV_ATAPI) {
3942 ata_dev_printk(dev, KERN_INFO, "class mismatch %u != %u\n",
3943 dev->class, new_class);
3949 rc = ata_dev_reread_id(dev, readid_flags);
3953 /* configure device according to the new ID */
3954 rc = ata_dev_configure(dev);
3958 /* verify n_sectors hasn't changed */
3959 if (dev->class == ATA_DEV_ATA && n_sectors &&
3960 dev->n_sectors != n_sectors) {
3961 ata_dev_printk(dev, KERN_INFO, "n_sectors mismatch "
3963 (unsigned long long)n_sectors,
3964 (unsigned long long)dev->n_sectors);
3966 /* restore original n_sectors */
3967 dev->n_sectors = n_sectors;
3976 ata_dev_printk(dev, KERN_ERR, "revalidation failed (errno=%d)\n", rc);
3980 struct ata_blacklist_entry {
3981 const char *model_num;
3982 const char *model_rev;
3983 unsigned long horkage;
3986 static const struct ata_blacklist_entry ata_device_blacklist [] = {
3987 /* Devices with DMA related problems under Linux */
3988 { "WDC AC11000H", NULL, ATA_HORKAGE_NODMA },
3989 { "WDC AC22100H", NULL, ATA_HORKAGE_NODMA },
3990 { "WDC AC32500H", NULL, ATA_HORKAGE_NODMA },
3991 { "WDC AC33100H", NULL, ATA_HORKAGE_NODMA },
3992 { "WDC AC31600H", NULL, ATA_HORKAGE_NODMA },
3993 { "WDC AC32100H", "24.09P07", ATA_HORKAGE_NODMA },
3994 { "WDC AC23200L", "21.10N21", ATA_HORKAGE_NODMA },
3995 { "Compaq CRD-8241B", NULL, ATA_HORKAGE_NODMA },
3996 { "CRD-8400B", NULL, ATA_HORKAGE_NODMA },
3997 { "CRD-8480B", NULL, ATA_HORKAGE_NODMA },
3998 { "CRD-8482B", NULL, ATA_HORKAGE_NODMA },
3999 { "CRD-84", NULL, ATA_HORKAGE_NODMA },
4000 { "SanDisk SDP3B", NULL, ATA_HORKAGE_NODMA },
4001 { "SanDisk SDP3B-64", NULL, ATA_HORKAGE_NODMA },
4002 { "SANYO CD-ROM CRD", NULL, ATA_HORKAGE_NODMA },
4003 { "HITACHI CDR-8", NULL, ATA_HORKAGE_NODMA },
4004 { "HITACHI CDR-8335", NULL, ATA_HORKAGE_NODMA },
4005 { "HITACHI CDR-8435", NULL, ATA_HORKAGE_NODMA },
4006 { "Toshiba CD-ROM XM-6202B", NULL, ATA_HORKAGE_NODMA },
4007 { "TOSHIBA CD-ROM XM-1702BC", NULL, ATA_HORKAGE_NODMA },
4008 { "CD-532E-A", NULL, ATA_HORKAGE_NODMA },
4009 { "E-IDE CD-ROM CR-840",NULL, ATA_HORKAGE_NODMA },
4010 { "CD-ROM Drive/F5A", NULL, ATA_HORKAGE_NODMA },
4011 { "WPI CDD-820", NULL, ATA_HORKAGE_NODMA },
4012 { "SAMSUNG CD-ROM SC-148C", NULL, ATA_HORKAGE_NODMA },
4013 { "SAMSUNG CD-ROM SC", NULL, ATA_HORKAGE_NODMA },
4014 { "ATAPI CD-ROM DRIVE 40X MAXIMUM",NULL,ATA_HORKAGE_NODMA },
4015 { "_NEC DV5800A", NULL, ATA_HORKAGE_NODMA },
4016 { "SAMSUNG CD-ROM SN-124", "N001", ATA_HORKAGE_NODMA },
4017 { "Seagate STT20000A", NULL, ATA_HORKAGE_NODMA },
4018 /* Odd clown on sil3726/4726 PMPs */
4019 { "Config Disk", NULL, ATA_HORKAGE_DISABLE },
4021 /* Weird ATAPI devices */
4022 { "TORiSAN DVD-ROM DRD-N216", NULL, ATA_HORKAGE_MAX_SEC_128 },
4024 /* Devices we expect to fail diagnostics */
4026 /* Devices where NCQ should be avoided */
4028 { "WDC WD740ADFD-00", NULL, ATA_HORKAGE_NONCQ },
4029 { "WDC WD740ADFD-00NLR1", NULL, ATA_HORKAGE_NONCQ, },
4030 /* http://thread.gmane.org/gmane.linux.ide/14907 */
4031 { "FUJITSU MHT2060BH", NULL, ATA_HORKAGE_NONCQ },
4033 { "Maxtor *", "BANC*", ATA_HORKAGE_NONCQ },
4034 { "Maxtor 7V300F0", "VA111630", ATA_HORKAGE_NONCQ },
4035 { "ST380817AS", "3.42", ATA_HORKAGE_NONCQ },
4036 { "ST3160023AS", "3.42", ATA_HORKAGE_NONCQ },
4038 /* Blacklist entries taken from Silicon Image 3124/3132
4039 Windows driver .inf file - also several Linux problem reports */
4040 { "HTS541060G9SA00", "MB3OC60D", ATA_HORKAGE_NONCQ, },
4041 { "HTS541080G9SA00", "MB4OC60D", ATA_HORKAGE_NONCQ, },
4042 { "HTS541010G9SA00", "MBZOC60D", ATA_HORKAGE_NONCQ, },
4044 /* devices which puke on READ_NATIVE_MAX */
4045 { "HDS724040KLSA80", "KFAOA20N", ATA_HORKAGE_BROKEN_HPA, },
4046 { "WDC WD3200JD-00KLB0", "WD-WCAMR1130137", ATA_HORKAGE_BROKEN_HPA },
4047 { "WDC WD2500JD-00HBB0", "WD-WMAL71490727", ATA_HORKAGE_BROKEN_HPA },
4048 { "MAXTOR 6L080L4", "A93.0500", ATA_HORKAGE_BROKEN_HPA },
4050 /* Devices which report 1 sector over size HPA */
4051 { "ST340823A", NULL, ATA_HORKAGE_HPA_SIZE, },
4052 { "ST320413A", NULL, ATA_HORKAGE_HPA_SIZE, },
4053 { "ST310211A", NULL, ATA_HORKAGE_HPA_SIZE, },
4055 /* Devices which get the IVB wrong */
4056 { "QUANTUM FIREBALLlct10 05", "A03.0900", ATA_HORKAGE_IVB, },
4057 /* Maybe we should just blacklist TSSTcorp... */
4058 { "TSSTcorp CDDVDW SH-S202H", "SB00", ATA_HORKAGE_IVB, },
4059 { "TSSTcorp CDDVDW SH-S202H", "SB01", ATA_HORKAGE_IVB, },
4060 { "TSSTcorp CDDVDW SH-S202J", "SB00", ATA_HORKAGE_IVB, },
4061 { "TSSTcorp CDDVDW SH-S202J", "SB01", ATA_HORKAGE_IVB, },
4062 { "TSSTcorp CDDVDW SH-S202N", "SB00", ATA_HORKAGE_IVB, },
4063 { "TSSTcorp CDDVDW SH-S202N", "SB01", ATA_HORKAGE_IVB, },
4069 static int strn_pattern_cmp(const char *patt, const char *name, int wildchar)
4075 * check for trailing wildcard: *\0
4077 p = strchr(patt, wildchar);
4078 if (p && ((*(p + 1)) == 0))
4089 return strncmp(patt, name, len);
4092 static unsigned long ata_dev_blacklisted(const struct ata_device *dev)
4094 unsigned char model_num[ATA_ID_PROD_LEN + 1];
4095 unsigned char model_rev[ATA_ID_FW_REV_LEN + 1];
4096 const struct ata_blacklist_entry *ad = ata_device_blacklist;
4098 ata_id_c_string(dev->id, model_num, ATA_ID_PROD, sizeof(model_num));
4099 ata_id_c_string(dev->id, model_rev, ATA_ID_FW_REV, sizeof(model_rev));
4101 while (ad->model_num) {
4102 if (!strn_pattern_cmp(ad->model_num, model_num, '*')) {
4103 if (ad->model_rev == NULL)
4105 if (!strn_pattern_cmp(ad->model_rev, model_rev, '*'))
4113 static int ata_dma_blacklisted(const struct ata_device *dev)
4115 /* We don't support polling DMA.
4116 * DMA blacklist those ATAPI devices with CDB-intr (and use PIO)
4117 * if the LLDD handles only interrupts in the HSM_ST_LAST state.
4119 if ((dev->link->ap->flags & ATA_FLAG_PIO_POLLING) &&
4120 (dev->flags & ATA_DFLAG_CDB_INTR))
4122 return (dev->horkage & ATA_HORKAGE_NODMA) ? 1 : 0;
4126 * ata_is_40wire - check drive side detection
4129 * Perform drive side detection decoding, allowing for device vendors
4130 * who can't follow the documentation.
4133 static int ata_is_40wire(struct ata_device *dev)
4135 if (dev->horkage & ATA_HORKAGE_IVB)
4136 return ata_drive_40wire_relaxed(dev->id);
4137 return ata_drive_40wire(dev->id);
4141 * cable_is_40wire - 40/80/SATA decider
4142 * @ap: port to consider
4144 * This function encapsulates the policy for speed management
4145 * in one place. At the moment we don't cache the result but
4146 * there is a good case for setting ap->cbl to the result when
4147 * we are called with unknown cables (and figuring out if it
4148 * impacts hotplug at all).
4150 * Return 1 if the cable appears to be 40 wire.
4153 static int cable_is_40wire(struct ata_port *ap)
4155 struct ata_link *link;
4156 struct ata_device *dev;
4158 /* If the controller thinks we are 40 wire, we are. */
4159 if (ap->cbl == ATA_CBL_PATA40)
4162 /* If the controller thinks we are 80 wire, we are. */
4163 if (ap->cbl == ATA_CBL_PATA80 || ap->cbl == ATA_CBL_SATA)
4166 /* If the system is known to be 40 wire short cable (eg
4167 * laptop), then we allow 80 wire modes even if the drive
4170 if (ap->cbl == ATA_CBL_PATA40_SHORT)
4173 /* If the controller doesn't know, we scan.
4175 * Note: We look for all 40 wire detects at this point. Any
4176 * 80 wire detect is taken to be 80 wire cable because
4177 * - in many setups only the one drive (slave if present) will
4178 * give a valid detect
4179 * - if you have a non detect capable drive you don't want it
4180 * to colour the choice
4182 ata_port_for_each_link(link, ap) {
4183 ata_link_for_each_dev(dev, link) {
4184 if (ata_dev_enabled(dev) && !ata_is_40wire(dev))
4192 * ata_dev_xfermask - Compute supported xfermask of the given device
4193 * @dev: Device to compute xfermask for
4195 * Compute supported xfermask of @dev and store it in
4196 * dev->*_mask. This function is responsible for applying all
4197 * known limits including host controller limits, device
4203 static void ata_dev_xfermask(struct ata_device *dev)
4205 struct ata_link *link = dev->link;
4206 struct ata_port *ap = link->ap;
4207 struct ata_host *host = ap->host;
4208 unsigned long xfer_mask;
4210 /* controller modes available */
4211 xfer_mask = ata_pack_xfermask(ap->pio_mask,
4212 ap->mwdma_mask, ap->udma_mask);
4214 /* drive modes available */
4215 xfer_mask &= ata_pack_xfermask(dev->pio_mask,
4216 dev->mwdma_mask, dev->udma_mask);
4217 xfer_mask &= ata_id_xfermask(dev->id);
4220 * CFA Advanced TrueIDE timings are not allowed on a shared
4223 if (ata_dev_pair(dev)) {
4224 /* No PIO5 or PIO6 */
4225 xfer_mask &= ~(0x03 << (ATA_SHIFT_PIO + 5));
4226 /* No MWDMA3 or MWDMA 4 */
4227 xfer_mask &= ~(0x03 << (ATA_SHIFT_MWDMA + 3));
4230 if (ata_dma_blacklisted(dev)) {
4231 xfer_mask &= ~(ATA_MASK_MWDMA | ATA_MASK_UDMA);
4232 ata_dev_printk(dev, KERN_WARNING,
4233 "device is on DMA blacklist, disabling DMA\n");
4236 if ((host->flags & ATA_HOST_SIMPLEX) &&
4237 host->simplex_claimed && host->simplex_claimed != ap) {
4238 xfer_mask &= ~(ATA_MASK_MWDMA | ATA_MASK_UDMA);
4239 ata_dev_printk(dev, KERN_WARNING, "simplex DMA is claimed by "
4240 "other device, disabling DMA\n");
4243 if (ap->flags & ATA_FLAG_NO_IORDY)
4244 xfer_mask &= ata_pio_mask_no_iordy(dev);
4246 if (ap->ops->mode_filter)
4247 xfer_mask = ap->ops->mode_filter(dev, xfer_mask);
4249 /* Apply cable rule here. Don't apply it early because when
4250 * we handle hot plug the cable type can itself change.
4251 * Check this last so that we know if the transfer rate was
4252 * solely limited by the cable.
4253 * Unknown or 80 wire cables reported host side are checked
4254 * drive side as well. Cases where we know a 40wire cable
4255 * is used safely for 80 are not checked here.
4257 if (xfer_mask & (0xF8 << ATA_SHIFT_UDMA))
4258 /* UDMA/44 or higher would be available */
4259 if (cable_is_40wire(ap)) {
4260 ata_dev_printk(dev, KERN_WARNING,
4261 "limited to UDMA/33 due to 40-wire cable\n");
4262 xfer_mask &= ~(0xF8 << ATA_SHIFT_UDMA);
4265 ata_unpack_xfermask(xfer_mask, &dev->pio_mask,
4266 &dev->mwdma_mask, &dev->udma_mask);
4270 * ata_dev_set_xfermode - Issue SET FEATURES - XFER MODE command
4271 * @dev: Device to which command will be sent
4273 * Issue SET FEATURES - XFER MODE command to device @dev
4277 * PCI/etc. bus probe sem.
4280 * 0 on success, AC_ERR_* mask otherwise.
4283 static unsigned int ata_dev_set_xfermode(struct ata_device *dev)
4285 struct ata_taskfile tf;
4286 unsigned int err_mask;
4288 /* set up set-features taskfile */
4289 DPRINTK("set features - xfer mode\n");
4291 /* Some controllers and ATAPI devices show flaky interrupt
4292 * behavior after setting xfer mode. Use polling instead.
4294 ata_tf_init(dev, &tf);
4295 tf.command = ATA_CMD_SET_FEATURES;
4296 tf.feature = SETFEATURES_XFER;
4297 tf.flags |= ATA_TFLAG_ISADDR | ATA_TFLAG_DEVICE | ATA_TFLAG_POLLING;
4298 tf.protocol = ATA_PROT_NODATA;
4299 /* If we are using IORDY we must send the mode setting command */
4300 if (ata_pio_need_iordy(dev))
4301 tf.nsect = dev->xfer_mode;
4302 /* If the device has IORDY and the controller does not - turn it off */
4303 else if (ata_id_has_iordy(dev->id))
4305 else /* In the ancient relic department - skip all of this */
4308 err_mask = ata_exec_internal(dev, &tf, NULL, DMA_NONE, NULL, 0, 0);
4310 DPRINTK("EXIT, err_mask=%x\n", err_mask);
4314 * ata_dev_set_feature - Issue SET FEATURES - SATA FEATURES
4315 * @dev: Device to which command will be sent
4316 * @enable: Whether to enable or disable the feature
4317 * @feature: The sector count represents the feature to set
4319 * Issue SET FEATURES - SATA FEATURES command to device @dev
4320 * on port @ap with sector count
4323 * PCI/etc. bus probe sem.
4326 * 0 on success, AC_ERR_* mask otherwise.
4328 static unsigned int ata_dev_set_feature(struct ata_device *dev, u8 enable,
4331 struct ata_taskfile tf;
4332 unsigned int err_mask;
4334 /* set up set-features taskfile */
4335 DPRINTK("set features - SATA features\n");
4337 ata_tf_init(dev, &tf);
4338 tf.command = ATA_CMD_SET_FEATURES;
4339 tf.feature = enable;
4340 tf.flags |= ATA_TFLAG_ISADDR | ATA_TFLAG_DEVICE;
4341 tf.protocol = ATA_PROT_NODATA;
4344 err_mask = ata_exec_internal(dev, &tf, NULL, DMA_NONE, NULL, 0, 0);
4346 DPRINTK("EXIT, err_mask=%x\n", err_mask);
4351 * ata_dev_init_params - Issue INIT DEV PARAMS command
4352 * @dev: Device to which command will be sent
4353 * @heads: Number of heads (taskfile parameter)
4354 * @sectors: Number of sectors (taskfile parameter)
4357 * Kernel thread context (may sleep)
4360 * 0 on success, AC_ERR_* mask otherwise.
4362 static unsigned int ata_dev_init_params(struct ata_device *dev,
4363 u16 heads, u16 sectors)
4365 struct ata_taskfile tf;
4366 unsigned int err_mask;
4368 /* Number of sectors per track 1-255. Number of heads 1-16 */
4369 if (sectors < 1 || sectors > 255 || heads < 1 || heads > 16)
4370 return AC_ERR_INVALID;
4372 /* set up init dev params taskfile */
4373 DPRINTK("init dev params \n");
4375 ata_tf_init(dev, &tf);
4376 tf.command = ATA_CMD_INIT_DEV_PARAMS;
4377 tf.flags |= ATA_TFLAG_ISADDR | ATA_TFLAG_DEVICE;
4378 tf.protocol = ATA_PROT_NODATA;
4380 tf.device |= (heads - 1) & 0x0f; /* max head = num. of heads - 1 */
4382 err_mask = ata_exec_internal(dev, &tf, NULL, DMA_NONE, NULL, 0, 0);
4383 /* A clean abort indicates an original or just out of spec drive
4384 and we should continue as we issue the setup based on the
4385 drive reported working geometry */
4386 if (err_mask == AC_ERR_DEV && (tf.feature & ATA_ABORTED))
4389 DPRINTK("EXIT, err_mask=%x\n", err_mask);
4394 * ata_sg_clean - Unmap DMA memory associated with command
4395 * @qc: Command containing DMA memory to be released
4397 * Unmap all mapped DMA memory associated with this command.
4400 * spin_lock_irqsave(host lock)
4402 void ata_sg_clean(struct ata_queued_cmd *qc)
4404 struct ata_port *ap = qc->ap;
4405 struct scatterlist *sg = qc->sg;
4406 int dir = qc->dma_dir;
4408 WARN_ON(sg == NULL);
4410 VPRINTK("unmapping %u sg elements\n", qc->n_elem);
4413 dma_unmap_sg(ap->dev, sg, qc->n_elem, dir);
4415 qc->flags &= ~ATA_QCFLAG_DMAMAP;
4420 * atapi_check_dma - Check whether ATAPI DMA can be supported
4421 * @qc: Metadata associated with taskfile to check
4423 * Allow low-level driver to filter ATA PACKET commands, returning
4424 * a status indicating whether or not it is OK to use DMA for the
4425 * supplied PACKET command.
4428 * spin_lock_irqsave(host lock)
4430 * RETURNS: 0 when ATAPI DMA can be used
4433 int atapi_check_dma(struct ata_queued_cmd *qc)
4435 struct ata_port *ap = qc->ap;
4437 /* Don't allow DMA if it isn't multiple of 16 bytes. Quite a
4438 * few ATAPI devices choke on such DMA requests.
4440 if (unlikely(qc->nbytes & 15))
4443 if (ap->ops->check_atapi_dma)
4444 return ap->ops->check_atapi_dma(qc);
4450 * ata_std_qc_defer - Check whether a qc needs to be deferred
4451 * @qc: ATA command in question
4453 * Non-NCQ commands cannot run with any other command, NCQ or
4454 * not. As upper layer only knows the queue depth, we are
4455 * responsible for maintaining exclusion. This function checks
4456 * whether a new command @qc can be issued.
4459 * spin_lock_irqsave(host lock)
4462 * ATA_DEFER_* if deferring is needed, 0 otherwise.
4464 int ata_std_qc_defer(struct ata_queued_cmd *qc)
4466 struct ata_link *link = qc->dev->link;
4468 if (qc->tf.protocol == ATA_PROT_NCQ) {
4469 if (!ata_tag_valid(link->active_tag))
4472 if (!ata_tag_valid(link->active_tag) && !link->sactive)
4476 return ATA_DEFER_LINK;
4479 void ata_noop_qc_prep(struct ata_queued_cmd *qc) { }
4482 * ata_sg_init - Associate command with scatter-gather table.
4483 * @qc: Command to be associated
4484 * @sg: Scatter-gather table.
4485 * @n_elem: Number of elements in s/g table.
4487 * Initialize the data-related elements of queued_cmd @qc
4488 * to point to a scatter-gather table @sg, containing @n_elem
4492 * spin_lock_irqsave(host lock)
4494 void ata_sg_init(struct ata_queued_cmd *qc, struct scatterlist *sg,
4495 unsigned int n_elem)
4498 qc->n_elem = n_elem;
4503 * ata_sg_setup - DMA-map the scatter-gather table associated with a command.
4504 * @qc: Command with scatter-gather table to be mapped.
4506 * DMA-map the scatter-gather table associated with queued_cmd @qc.
4509 * spin_lock_irqsave(host lock)
4512 * Zero on success, negative on error.
4515 static int ata_sg_setup(struct ata_queued_cmd *qc)
4517 struct ata_port *ap = qc->ap;
4518 unsigned int n_elem;
4520 VPRINTK("ENTER, ata%u\n", ap->print_id);
4522 n_elem = dma_map_sg(ap->dev, qc->sg, qc->n_elem, qc->dma_dir);
4526 DPRINTK("%d sg elements mapped\n", n_elem);
4528 qc->n_elem = n_elem;
4529 qc->flags |= ATA_QCFLAG_DMAMAP;
4535 * swap_buf_le16 - swap halves of 16-bit words in place
4536 * @buf: Buffer to swap
4537 * @buf_words: Number of 16-bit words in buffer.
4539 * Swap halves of 16-bit words if needed to convert from
4540 * little-endian byte order to native cpu byte order, or
4544 * Inherited from caller.
4546 void swap_buf_le16(u16 *buf, unsigned int buf_words)
4551 for (i = 0; i < buf_words; i++)
4552 buf[i] = le16_to_cpu(buf[i]);
4553 #endif /* __BIG_ENDIAN */
4557 * ata_qc_new_init - Request an available ATA command, and initialize it
4558 * @dev: Device from whom we request an available command structure
4565 struct ata_queued_cmd *ata_qc_new_init(struct ata_device *dev, int tag)
4567 struct ata_port *ap = dev->link->ap;
4568 struct ata_queued_cmd *qc;
4570 if (unlikely(ap->pflags & ATA_PFLAG_FROZEN))
4573 qc = __ata_qc_from_tag(ap, tag);
4586 void __ata_qc_complete(struct ata_queued_cmd *qc)
4588 struct ata_port *ap = qc->ap;
4589 struct ata_link *link = qc->dev->link;
4591 WARN_ON(qc == NULL); /* ata_qc_from_tag _might_ return NULL */
4592 WARN_ON(!(qc->flags & ATA_QCFLAG_ACTIVE));
4594 if (likely(qc->flags & ATA_QCFLAG_DMAMAP))
4597 /* command should be marked inactive atomically with qc completion */
4598 if (qc->tf.protocol == ATA_PROT_NCQ) {
4599 link->sactive &= ~(1 << qc->tag);
4601 ap->nr_active_links--;
4603 link->active_tag = ATA_TAG_POISON;
4604 ap->nr_active_links--;
4607 /* clear exclusive status */
4608 if (unlikely(qc->flags & ATA_QCFLAG_CLEAR_EXCL &&
4609 ap->excl_link == link))
4610 ap->excl_link = NULL;
4612 /* atapi: mark qc as inactive to prevent the interrupt handler
4613 * from completing the command twice later, before the error handler
4614 * is called. (when rc != 0 and atapi request sense is needed)
4616 qc->flags &= ~ATA_QCFLAG_ACTIVE;
4617 ap->qc_active &= ~(1 << qc->tag);
4619 /* call completion callback */
4620 qc->complete_fn(qc);
4623 static void fill_result_tf(struct ata_queued_cmd *qc)
4625 struct ata_port *ap = qc->ap;
4627 qc->result_tf.flags = qc->tf.flags;
4628 ap->ops->qc_fill_rtf(qc);
4631 static void ata_verify_xfer(struct ata_queued_cmd *qc)
4633 struct ata_device *dev = qc->dev;
4635 if (ata_tag_internal(qc->tag))
4638 if (ata_is_nodata(qc->tf.protocol))
4641 if ((dev->mwdma_mask || dev->udma_mask) && ata_is_pio(qc->tf.protocol))
4644 dev->flags &= ~ATA_DFLAG_DUBIOUS_XFER;
4648 * ata_qc_complete - Complete an active ATA command
4649 * @qc: Command to complete
4651 * Indicate to the mid and upper layers that an ATA
4652 * command has completed, with either an ok or not-ok status.
4655 * spin_lock_irqsave(host lock)
4657 void ata_qc_complete(struct ata_queued_cmd *qc)
4659 struct ata_port *ap = qc->ap;
4661 /* XXX: New EH and old EH use different mechanisms to
4662 * synchronize EH with regular execution path.
4664 * In new EH, a failed qc is marked with ATA_QCFLAG_FAILED.
4665 * Normal execution path is responsible for not accessing a
4666 * failed qc. libata core enforces the rule by returning NULL
4667 * from ata_qc_from_tag() for failed qcs.
4669 * Old EH depends on ata_qc_complete() nullifying completion
4670 * requests if ATA_QCFLAG_EH_SCHEDULED is set. Old EH does
4671 * not synchronize with interrupt handler. Only PIO task is
4674 if (ap->ops->error_handler) {
4675 struct ata_device *dev = qc->dev;
4676 struct ata_eh_info *ehi = &dev->link->eh_info;
4678 WARN_ON(ap->pflags & ATA_PFLAG_FROZEN);
4680 if (unlikely(qc->err_mask))
4681 qc->flags |= ATA_QCFLAG_FAILED;
4683 if (unlikely(qc->flags & ATA_QCFLAG_FAILED)) {
4684 if (!ata_tag_internal(qc->tag)) {
4685 /* always fill result TF for failed qc */
4687 ata_qc_schedule_eh(qc);
4692 /* read result TF if requested */
4693 if (qc->flags & ATA_QCFLAG_RESULT_TF)
4696 /* Some commands need post-processing after successful
4699 switch (qc->tf.command) {
4700 case ATA_CMD_SET_FEATURES:
4701 if (qc->tf.feature != SETFEATURES_WC_ON &&
4702 qc->tf.feature != SETFEATURES_WC_OFF)
4705 case ATA_CMD_INIT_DEV_PARAMS: /* CHS translation changed */
4706 case ATA_CMD_SET_MULTI: /* multi_count changed */
4707 /* revalidate device */
4708 ehi->dev_action[dev->devno] |= ATA_EH_REVALIDATE;
4709 ata_port_schedule_eh(ap);
4713 dev->flags |= ATA_DFLAG_SLEEPING;
4717 if (unlikely(dev->flags & ATA_DFLAG_DUBIOUS_XFER))
4718 ata_verify_xfer(qc);
4720 __ata_qc_complete(qc);
4722 if (qc->flags & ATA_QCFLAG_EH_SCHEDULED)
4725 /* read result TF if failed or requested */
4726 if (qc->err_mask || qc->flags & ATA_QCFLAG_RESULT_TF)
4729 __ata_qc_complete(qc);
4734 * ata_qc_complete_multiple - Complete multiple qcs successfully
4735 * @ap: port in question
4736 * @qc_active: new qc_active mask
4738 * Complete in-flight commands. This functions is meant to be
4739 * called from low-level driver's interrupt routine to complete
4740 * requests normally. ap->qc_active and @qc_active is compared
4741 * and commands are completed accordingly.
4744 * spin_lock_irqsave(host lock)
4747 * Number of completed commands on success, -errno otherwise.
4749 int ata_qc_complete_multiple(struct ata_port *ap, u32 qc_active)
4755 done_mask = ap->qc_active ^ qc_active;
4757 if (unlikely(done_mask & qc_active)) {
4758 ata_port_printk(ap, KERN_ERR, "illegal qc_active transition "
4759 "(%08x->%08x)\n", ap->qc_active, qc_active);
4763 for (i = 0; i < ATA_MAX_QUEUE; i++) {
4764 struct ata_queued_cmd *qc;
4766 if (!(done_mask & (1 << i)))
4769 if ((qc = ata_qc_from_tag(ap, i))) {
4770 ata_qc_complete(qc);
4779 * ata_qc_issue - issue taskfile to device
4780 * @qc: command to issue to device
4782 * Prepare an ATA command to submission to device.
4783 * This includes mapping the data into a DMA-able
4784 * area, filling in the S/G table, and finally
4785 * writing the taskfile to hardware, starting the command.
4788 * spin_lock_irqsave(host lock)
4790 void ata_qc_issue(struct ata_queued_cmd *qc)
4792 struct ata_port *ap = qc->ap;
4793 struct ata_link *link = qc->dev->link;
4794 u8 prot = qc->tf.protocol;
4796 /* Make sure only one non-NCQ command is outstanding. The
4797 * check is skipped for old EH because it reuses active qc to
4798 * request ATAPI sense.
4800 WARN_ON(ap->ops->error_handler && ata_tag_valid(link->active_tag));
4802 if (ata_is_ncq(prot)) {
4803 WARN_ON(link->sactive & (1 << qc->tag));
4806 ap->nr_active_links++;
4807 link->sactive |= 1 << qc->tag;
4809 WARN_ON(link->sactive);
4811 ap->nr_active_links++;
4812 link->active_tag = qc->tag;
4815 qc->flags |= ATA_QCFLAG_ACTIVE;
4816 ap->qc_active |= 1 << qc->tag;
4818 /* We guarantee to LLDs that they will have at least one
4819 * non-zero sg if the command is a data command.
4821 BUG_ON(ata_is_data(prot) && (!qc->sg || !qc->n_elem || !qc->nbytes));
4823 if (ata_is_dma(prot) || (ata_is_pio(prot) &&
4824 (ap->flags & ATA_FLAG_PIO_DMA)))
4825 if (ata_sg_setup(qc))
4828 /* if device is sleeping, schedule reset and abort the link */
4829 if (unlikely(qc->dev->flags & ATA_DFLAG_SLEEPING)) {
4830 link->eh_info.action |= ATA_EH_RESET;
4831 ata_ehi_push_desc(&link->eh_info, "waking up from sleep");
4832 ata_link_abort(link);
4836 ap->ops->qc_prep(qc);
4838 qc->err_mask |= ap->ops->qc_issue(qc);
4839 if (unlikely(qc->err_mask))
4844 qc->err_mask |= AC_ERR_SYSTEM;
4846 ata_qc_complete(qc);
4850 * sata_scr_valid - test whether SCRs are accessible
4851 * @link: ATA link to test SCR accessibility for
4853 * Test whether SCRs are accessible for @link.
4859 * 1 if SCRs are accessible, 0 otherwise.
4861 int sata_scr_valid(struct ata_link *link)
4863 struct ata_port *ap = link->ap;
4865 return (ap->flags & ATA_FLAG_SATA) && ap->ops->scr_read;
4869 * sata_scr_read - read SCR register of the specified port
4870 * @link: ATA link to read SCR for
4872 * @val: Place to store read value
4874 * Read SCR register @reg of @link into *@val. This function is
4875 * guaranteed to succeed if @link is ap->link, the cable type of
4876 * the port is SATA and the port implements ->scr_read.
4879 * None if @link is ap->link. Kernel thread context otherwise.
4882 * 0 on success, negative errno on failure.
4884 int sata_scr_read(struct ata_link *link, int reg, u32 *val)
4886 if (ata_is_host_link(link)) {
4887 if (sata_scr_valid(link))
4888 return link->ap->ops->scr_read(link, reg, val);
4892 return sata_pmp_scr_read(link, reg, val);
4896 * sata_scr_write - write SCR register of the specified port
4897 * @link: ATA link to write SCR for
4898 * @reg: SCR to write
4899 * @val: value to write
4901 * Write @val to SCR register @reg of @link. This function is
4902 * guaranteed to succeed if @link is ap->link, the cable type of
4903 * the port is SATA and the port implements ->scr_read.
4906 * None if @link is ap->link. Kernel thread context otherwise.
4909 * 0 on success, negative errno on failure.
4911 int sata_scr_write(struct ata_link *link, int reg, u32 val)
4913 if (ata_is_host_link(link)) {
4914 if (sata_scr_valid(link))
4915 return link->ap->ops->scr_write(link, reg, val);
4919 return sata_pmp_scr_write(link, reg, val);
4923 * sata_scr_write_flush - write SCR register of the specified port and flush
4924 * @link: ATA link to write SCR for
4925 * @reg: SCR to write
4926 * @val: value to write
4928 * This function is identical to sata_scr_write() except that this
4929 * function performs flush after writing to the register.
4932 * None if @link is ap->link. Kernel thread context otherwise.
4935 * 0 on success, negative errno on failure.
4937 int sata_scr_write_flush(struct ata_link *link, int reg, u32 val)
4939 if (ata_is_host_link(link)) {
4942 if (sata_scr_valid(link)) {
4943 rc = link->ap->ops->scr_write(link, reg, val);
4945 rc = link->ap->ops->scr_read(link, reg, &val);
4951 return sata_pmp_scr_write(link, reg, val);
4955 * ata_phys_link_online - test whether the given link is online
4956 * @link: ATA link to test
4958 * Test whether @link is online. Note that this function returns
4959 * 0 if online status of @link cannot be obtained, so
4960 * ata_link_online(link) != !ata_link_offline(link).
4966 * True if the port online status is available and online.
4968 bool ata_phys_link_online(struct ata_link *link)
4972 if (sata_scr_read(link, SCR_STATUS, &sstatus) == 0 &&
4973 (sstatus & 0xf) == 0x3)
4979 * ata_phys_link_offline - test whether the given link is offline
4980 * @link: ATA link to test
4982 * Test whether @link is offline. Note that this function
4983 * returns 0 if offline status of @link cannot be obtained, so
4984 * ata_link_online(link) != !ata_link_offline(link).
4990 * True if the port offline status is available and offline.
4992 bool ata_phys_link_offline(struct ata_link *link)
4996 if (sata_scr_read(link, SCR_STATUS, &sstatus) == 0 &&
4997 (sstatus & 0xf) != 0x3)
5003 * ata_link_online - test whether the given link is online
5004 * @link: ATA link to test
5006 * Test whether @link is online. This is identical to
5007 * ata_phys_link_online() when there's no slave link. When
5008 * there's a slave link, this function should only be called on
5009 * the master link and will return true if any of M/S links is
5016 * True if the port online status is available and online.
5018 bool ata_link_online(struct ata_link *link)
5020 struct ata_link *slave = link->ap->slave_link;
5022 WARN_ON(link == slave); /* shouldn't be called on slave link */
5024 return ata_phys_link_online(link) ||
5025 (slave && ata_phys_link_online(slave));
5029 * ata_link_offline - test whether the given link is offline
5030 * @link: ATA link to test
5032 * Test whether @link is offline. This is identical to
5033 * ata_phys_link_offline() when there's no slave link. When
5034 * there's a slave link, this function should only be called on
5035 * the master link and will return true if both M/S links are
5042 * True if the port offline status is available and offline.
5044 bool ata_link_offline(struct ata_link *link)
5046 struct ata_link *slave = link->ap->slave_link;
5048 WARN_ON(link == slave); /* shouldn't be called on slave link */
5050 return ata_phys_link_offline(link) &&
5051 (!slave || ata_phys_link_offline(slave));
5055 static int ata_host_request_pm(struct ata_host *host, pm_message_t mesg,
5056 unsigned int action, unsigned int ehi_flags,
5059 unsigned long flags;
5062 for (i = 0; i < host->n_ports; i++) {
5063 struct ata_port *ap = host->ports[i];
5064 struct ata_link *link;
5066 /* Previous resume operation might still be in
5067 * progress. Wait for PM_PENDING to clear.
5069 if (ap->pflags & ATA_PFLAG_PM_PENDING) {
5070 ata_port_wait_eh(ap);
5071 WARN_ON(ap->pflags & ATA_PFLAG_PM_PENDING);
5074 /* request PM ops to EH */
5075 spin_lock_irqsave(ap->lock, flags);
5080 ap->pm_result = &rc;
5083 ap->pflags |= ATA_PFLAG_PM_PENDING;
5084 __ata_port_for_each_link(link, ap) {
5085 link->eh_info.action |= action;
5086 link->eh_info.flags |= ehi_flags;
5089 ata_port_schedule_eh(ap);
5091 spin_unlock_irqrestore(ap->lock, flags);
5093 /* wait and check result */
5095 ata_port_wait_eh(ap);
5096 WARN_ON(ap->pflags & ATA_PFLAG_PM_PENDING);
5106 * ata_host_suspend - suspend host
5107 * @host: host to suspend
5110 * Suspend @host. Actual operation is performed by EH. This
5111 * function requests EH to perform PM operations and waits for EH
5115 * Kernel thread context (may sleep).
5118 * 0 on success, -errno on failure.
5120 int ata_host_suspend(struct ata_host *host, pm_message_t mesg)
5125 * disable link pm on all ports before requesting
5128 ata_lpm_enable(host);
5130 rc = ata_host_request_pm(host, mesg, 0, ATA_EHI_QUIET, 1);
5132 host->dev->power.power_state = mesg;
5137 * ata_host_resume - resume host
5138 * @host: host to resume
5140 * Resume @host. Actual operation is performed by EH. This
5141 * function requests EH to perform PM operations and returns.
5142 * Note that all resume operations are performed parallely.
5145 * Kernel thread context (may sleep).
5147 void ata_host_resume(struct ata_host *host)
5149 ata_host_request_pm(host, PMSG_ON, ATA_EH_RESET,
5150 ATA_EHI_NO_AUTOPSY | ATA_EHI_QUIET, 0);
5151 host->dev->power.power_state = PMSG_ON;
5153 /* reenable link pm */
5154 ata_lpm_disable(host);
5159 * ata_port_start - Set port up for dma.
5160 * @ap: Port to initialize
5162 * Called just after data structures for each port are
5163 * initialized. Allocates space for PRD table.
5165 * May be used as the port_start() entry in ata_port_operations.
5168 * Inherited from caller.
5170 int ata_port_start(struct ata_port *ap)
5172 struct device *dev = ap->dev;
5174 ap->prd = dmam_alloc_coherent(dev, ATA_PRD_TBL_SZ, &ap->prd_dma,
5183 * ata_dev_init - Initialize an ata_device structure
5184 * @dev: Device structure to initialize
5186 * Initialize @dev in preparation for probing.
5189 * Inherited from caller.
5191 void ata_dev_init(struct ata_device *dev)
5193 struct ata_link *link = ata_dev_phys_link(dev);
5194 struct ata_port *ap = link->ap;
5195 unsigned long flags;
5197 /* SATA spd limit is bound to the attached device, reset together */
5198 link->sata_spd_limit = link->hw_sata_spd_limit;
5201 /* High bits of dev->flags are used to record warm plug
5202 * requests which occur asynchronously. Synchronize using
5205 spin_lock_irqsave(ap->lock, flags);
5206 dev->flags &= ~ATA_DFLAG_INIT_MASK;
5208 spin_unlock_irqrestore(ap->lock, flags);
5210 memset((void *)dev + ATA_DEVICE_CLEAR_OFFSET, 0,
5211 sizeof(*dev) - ATA_DEVICE_CLEAR_OFFSET);
5212 dev->pio_mask = UINT_MAX;
5213 dev->mwdma_mask = UINT_MAX;
5214 dev->udma_mask = UINT_MAX;
5218 * ata_link_init - Initialize an ata_link structure
5219 * @ap: ATA port link is attached to
5220 * @link: Link structure to initialize
5221 * @pmp: Port multiplier port number
5226 * Kernel thread context (may sleep)
5228 void ata_link_init(struct ata_port *ap, struct ata_link *link, int pmp)
5232 /* clear everything except for devices */
5233 memset(link, 0, offsetof(struct ata_link, device[0]));
5237 link->active_tag = ATA_TAG_POISON;
5238 link->hw_sata_spd_limit = UINT_MAX;
5240 /* can't use iterator, ap isn't initialized yet */
5241 for (i = 0; i < ATA_MAX_DEVICES; i++) {
5242 struct ata_device *dev = &link->device[i];
5245 dev->devno = dev - link->device;
5251 * sata_link_init_spd - Initialize link->sata_spd_limit
5252 * @link: Link to configure sata_spd_limit for
5254 * Initialize @link->[hw_]sata_spd_limit to the currently
5258 * Kernel thread context (may sleep).
5261 * 0 on success, -errno on failure.
5263 int sata_link_init_spd(struct ata_link *link)
5268 rc = sata_scr_read(link, SCR_CONTROL, &link->saved_scontrol);
5272 spd = (link->saved_scontrol >> 4) & 0xf;
5274 link->hw_sata_spd_limit &= (1 << spd) - 1;
5276 ata_force_link_limits(link);
5278 link->sata_spd_limit = link->hw_sata_spd_limit;
5284 * ata_port_alloc - allocate and initialize basic ATA port resources
5285 * @host: ATA host this allocated port belongs to
5287 * Allocate and initialize basic ATA port resources.
5290 * Allocate ATA port on success, NULL on failure.
5293 * Inherited from calling layer (may sleep).
5295 struct ata_port *ata_port_alloc(struct ata_host *host)
5297 struct ata_port *ap;
5301 ap = kzalloc(sizeof(*ap), GFP_KERNEL);
5305 ap->pflags |= ATA_PFLAG_INITIALIZING;
5306 ap->lock = &host->lock;
5307 ap->flags = ATA_FLAG_DISABLED;
5309 ap->ctl = ATA_DEVCTL_OBS;
5311 ap->dev = host->dev;
5312 ap->last_ctl = 0xFF;
5314 #if defined(ATA_VERBOSE_DEBUG)
5315 /* turn on all debugging levels */
5316 ap->msg_enable = 0x00FF;
5317 #elif defined(ATA_DEBUG)
5318 ap->msg_enable = ATA_MSG_DRV | ATA_MSG_INFO | ATA_MSG_CTL | ATA_MSG_WARN | ATA_MSG_ERR;
5320 ap->msg_enable = ATA_MSG_DRV | ATA_MSG_ERR | ATA_MSG_WARN;
5323 #ifdef CONFIG_ATA_SFF
5324 INIT_DELAYED_WORK(&ap->port_task, ata_pio_task);
5326 INIT_DELAYED_WORK(&ap->port_task, NULL);
5328 INIT_DELAYED_WORK(&ap->hotplug_task, ata_scsi_hotplug);
5329 INIT_WORK(&ap->scsi_rescan_task, ata_scsi_dev_rescan);
5330 INIT_LIST_HEAD(&ap->eh_done_q);
5331 init_waitqueue_head(&ap->eh_wait_q);
5332 init_completion(&ap->park_req_pending);
5333 init_timer_deferrable(&ap->fastdrain_timer);
5334 ap->fastdrain_timer.function = ata_eh_fastdrain_timerfn;
5335 ap->fastdrain_timer.data = (unsigned long)ap;
5337 ap->cbl = ATA_CBL_NONE;
5339 ata_link_init(ap, &ap->link, 0);
5342 ap->stats.unhandled_irq = 1;
5343 ap->stats.idle_irq = 1;
5348 static void ata_host_release(struct device *gendev, void *res)
5350 struct ata_host *host = dev_get_drvdata(gendev);
5353 for (i = 0; i < host->n_ports; i++) {
5354 struct ata_port *ap = host->ports[i];
5360 scsi_host_put(ap->scsi_host);
5362 kfree(ap->pmp_link);
5363 kfree(ap->slave_link);
5365 host->ports[i] = NULL;
5368 dev_set_drvdata(gendev, NULL);
5372 * ata_host_alloc - allocate and init basic ATA host resources
5373 * @dev: generic device this host is associated with
5374 * @max_ports: maximum number of ATA ports associated with this host
5376 * Allocate and initialize basic ATA host resources. LLD calls
5377 * this function to allocate a host, initializes it fully and
5378 * attaches it using ata_host_register().
5380 * @max_ports ports are allocated and host->n_ports is
5381 * initialized to @max_ports. The caller is allowed to decrease
5382 * host->n_ports before calling ata_host_register(). The unused
5383 * ports will be automatically freed on registration.
5386 * Allocate ATA host on success, NULL on failure.
5389 * Inherited from calling layer (may sleep).
5391 struct ata_host *ata_host_alloc(struct device *dev, int max_ports)
5393 struct ata_host *host;
5399 if (!devres_open_group(dev, NULL, GFP_KERNEL))
5402 /* alloc a container for our list of ATA ports (buses) */
5403 sz = sizeof(struct ata_host) + (max_ports + 1) * sizeof(void *);
5404 /* alloc a container for our list of ATA ports (buses) */
5405 host = devres_alloc(ata_host_release, sz, GFP_KERNEL);
5409 devres_add(dev, host);
5410 dev_set_drvdata(dev, host);
5412 spin_lock_init(&host->lock);
5414 host->n_ports = max_ports;
5416 /* allocate ports bound to this host */
5417 for (i = 0; i < max_ports; i++) {
5418 struct ata_port *ap;
5420 ap = ata_port_alloc(host);
5425 host->ports[i] = ap;
5428 devres_remove_group(dev, NULL);
5432 devres_release_group(dev, NULL);
5437 * ata_host_alloc_pinfo - alloc host and init with port_info array
5438 * @dev: generic device this host is associated with
5439 * @ppi: array of ATA port_info to initialize host with
5440 * @n_ports: number of ATA ports attached to this host
5442 * Allocate ATA host and initialize with info from @ppi. If NULL
5443 * terminated, @ppi may contain fewer entries than @n_ports. The
5444 * last entry will be used for the remaining ports.
5447 * Allocate ATA host on success, NULL on failure.
5450 * Inherited from calling layer (may sleep).
5452 struct ata_host *ata_host_alloc_pinfo(struct device *dev,
5453 const struct ata_port_info * const * ppi,
5456 const struct ata_port_info *pi;
5457 struct ata_host *host;
5460 host = ata_host_alloc(dev, n_ports);
5464 for (i = 0, j = 0, pi = NULL; i < host->n_ports; i++) {
5465 struct ata_port *ap = host->ports[i];
5470 ap->pio_mask = pi->pio_mask;
5471 ap->mwdma_mask = pi->mwdma_mask;
5472 ap->udma_mask = pi->udma_mask;
5473 ap->flags |= pi->flags;
5474 ap->link.flags |= pi->link_flags;
5475 ap->ops = pi->port_ops;
5477 if (!host->ops && (pi->port_ops != &ata_dummy_port_ops))
5478 host->ops = pi->port_ops;
5485 * ata_slave_link_init - initialize slave link
5486 * @ap: port to initialize slave link for
5488 * Create and initialize slave link for @ap. This enables slave
5489 * link handling on the port.
5491 * In libata, a port contains links and a link contains devices.
5492 * There is single host link but if a PMP is attached to it,
5493 * there can be multiple fan-out links. On SATA, there's usually
5494 * a single device connected to a link but PATA and SATA
5495 * controllers emulating TF based interface can have two - master
5498 * However, there are a few controllers which don't fit into this
5499 * abstraction too well - SATA controllers which emulate TF
5500 * interface with both master and slave devices but also have
5501 * separate SCR register sets for each device. These controllers
5502 * need separate links for physical link handling
5503 * (e.g. onlineness, link speed) but should be treated like a
5504 * traditional M/S controller for everything else (e.g. command
5505 * issue, softreset).
5507 * slave_link is libata's way of handling this class of
5508 * controllers without impacting core layer too much. For
5509 * anything other than physical link handling, the default host
5510 * link is used for both master and slave. For physical link
5511 * handling, separate @ap->slave_link is used. All dirty details
5512 * are implemented inside libata core layer. From LLD's POV, the
5513 * only difference is that prereset, hardreset and postreset are
5514 * called once more for the slave link, so the reset sequence
5515 * looks like the following.
5517 * prereset(M) -> prereset(S) -> hardreset(M) -> hardreset(S) ->
5518 * softreset(M) -> postreset(M) -> postreset(S)
5520 * Note that softreset is called only for the master. Softreset
5521 * resets both M/S by definition, so SRST on master should handle
5522 * both (the standard method will work just fine).
5525 * Should be called before host is registered.
5528 * 0 on success, -errno on failure.
5530 int ata_slave_link_init(struct ata_port *ap)
5532 struct ata_link *link;
5534 WARN_ON(ap->slave_link);
5535 WARN_ON(ap->flags & ATA_FLAG_PMP);
5537 link = kzalloc(sizeof(*link), GFP_KERNEL);
5541 ata_link_init(ap, link, 1);
5542 ap->slave_link = link;
5546 static void ata_host_stop(struct device *gendev, void *res)
5548 struct ata_host *host = dev_get_drvdata(gendev);
5551 WARN_ON(!(host->flags & ATA_HOST_STARTED));
5553 for (i = 0; i < host->n_ports; i++) {
5554 struct ata_port *ap = host->ports[i];
5556 if (ap->ops->port_stop)
5557 ap->ops->port_stop(ap);
5560 if (host->ops->host_stop)
5561 host->ops->host_stop(host);
5565 * ata_finalize_port_ops - finalize ata_port_operations
5566 * @ops: ata_port_operations to finalize
5568 * An ata_port_operations can inherit from another ops and that
5569 * ops can again inherit from another. This can go on as many
5570 * times as necessary as long as there is no loop in the
5571 * inheritance chain.
5573 * Ops tables are finalized when the host is started. NULL or
5574 * unspecified entries are inherited from the closet ancestor
5575 * which has the method and the entry is populated with it.
5576 * After finalization, the ops table directly points to all the
5577 * methods and ->inherits is no longer necessary and cleared.
5579 * Using ATA_OP_NULL, inheriting ops can force a method to NULL.
5584 static void ata_finalize_port_ops(struct ata_port_operations *ops)
5586 static DEFINE_SPINLOCK(lock);
5587 const struct ata_port_operations *cur;
5588 void **begin = (void **)ops;
5589 void **end = (void **)&ops->inherits;
5592 if (!ops || !ops->inherits)
5597 for (cur = ops->inherits; cur; cur = cur->inherits) {
5598 void **inherit = (void **)cur;
5600 for (pp = begin; pp < end; pp++, inherit++)
5605 for (pp = begin; pp < end; pp++)
5609 ops->inherits = NULL;
5615 * ata_host_start - start and freeze ports of an ATA host
5616 * @host: ATA host to start ports for
5618 * Start and then freeze ports of @host. Started status is
5619 * recorded in host->flags, so this function can be called
5620 * multiple times. Ports are guaranteed to get started only
5621 * once. If host->ops isn't initialized yet, its set to the
5622 * first non-dummy port ops.
5625 * Inherited from calling layer (may sleep).
5628 * 0 if all ports are started successfully, -errno otherwise.
5630 int ata_host_start(struct ata_host *host)
5633 void *start_dr = NULL;
5636 if (host->flags & ATA_HOST_STARTED)
5639 ata_finalize_port_ops(host->ops);
5641 for (i = 0; i < host->n_ports; i++) {
5642 struct ata_port *ap = host->ports[i];
5644 ata_finalize_port_ops(ap->ops);
5646 if (!host->ops && !ata_port_is_dummy(ap))
5647 host->ops = ap->ops;
5649 if (ap->ops->port_stop)
5653 if (host->ops->host_stop)
5657 start_dr = devres_alloc(ata_host_stop, 0, GFP_KERNEL);
5662 for (i = 0; i < host->n_ports; i++) {
5663 struct ata_port *ap = host->ports[i];
5665 if (ap->ops->port_start) {
5666 rc = ap->ops->port_start(ap);
5669 dev_printk(KERN_ERR, host->dev,
5670 "failed to start port %d "
5671 "(errno=%d)\n", i, rc);
5675 ata_eh_freeze_port(ap);
5679 devres_add(host->dev, start_dr);
5680 host->flags |= ATA_HOST_STARTED;
5685 struct ata_port *ap = host->ports[i];
5687 if (ap->ops->port_stop)
5688 ap->ops->port_stop(ap);
5690 devres_free(start_dr);
5695 * ata_sas_host_init - Initialize a host struct
5696 * @host: host to initialize
5697 * @dev: device host is attached to
5698 * @flags: host flags
5702 * PCI/etc. bus probe sem.
5705 /* KILLME - the only user left is ipr */
5706 void ata_host_init(struct ata_host *host, struct device *dev,
5707 unsigned long flags, struct ata_port_operations *ops)
5709 spin_lock_init(&host->lock);
5711 host->flags = flags;
5716 * ata_host_register - register initialized ATA host
5717 * @host: ATA host to register
5718 * @sht: template for SCSI host
5720 * Register initialized ATA host. @host is allocated using
5721 * ata_host_alloc() and fully initialized by LLD. This function
5722 * starts ports, registers @host with ATA and SCSI layers and
5723 * probe registered devices.
5726 * Inherited from calling layer (may sleep).
5729 * 0 on success, -errno otherwise.
5731 int ata_host_register(struct ata_host *host, struct scsi_host_template *sht)
5735 /* host must have been started */
5736 if (!(host->flags & ATA_HOST_STARTED)) {
5737 dev_printk(KERN_ERR, host->dev,
5738 "BUG: trying to register unstarted host\n");
5743 /* Blow away unused ports. This happens when LLD can't
5744 * determine the exact number of ports to allocate at
5747 for (i = host->n_ports; host->ports[i]; i++)
5748 kfree(host->ports[i]);
5750 /* give ports names and add SCSI hosts */
5751 for (i = 0; i < host->n_ports; i++)
5752 host->ports[i]->print_id = ata_print_id++;
5754 rc = ata_scsi_add_hosts(host, sht);
5758 /* associate with ACPI nodes */
5759 ata_acpi_associate(host);
5761 /* set cable, sata_spd_limit and report */
5762 for (i = 0; i < host->n_ports; i++) {
5763 struct ata_port *ap = host->ports[i];
5764 unsigned long xfer_mask;
5766 /* set SATA cable type if still unset */
5767 if (ap->cbl == ATA_CBL_NONE && (ap->flags & ATA_FLAG_SATA))
5768 ap->cbl = ATA_CBL_SATA;
5770 /* init sata_spd_limit to the current value */
5771 sata_link_init_spd(&ap->link);
5773 sata_link_init_spd(ap->slave_link);
5775 /* print per-port info to dmesg */
5776 xfer_mask = ata_pack_xfermask(ap->pio_mask, ap->mwdma_mask,
5779 if (!ata_port_is_dummy(ap)) {
5780 ata_port_printk(ap, KERN_INFO,
5781 "%cATA max %s %s\n",
5782 (ap->flags & ATA_FLAG_SATA) ? 'S' : 'P',
5783 ata_mode_string(xfer_mask),
5784 ap->link.eh_info.desc);
5785 ata_ehi_clear_desc(&ap->link.eh_info);
5787 ata_port_printk(ap, KERN_INFO, "DUMMY\n");
5790 /* perform each probe synchronously */
5791 DPRINTK("probe begin\n");
5792 for (i = 0; i < host->n_ports; i++) {
5793 struct ata_port *ap = host->ports[i];
5796 if (ap->ops->error_handler) {
5797 struct ata_eh_info *ehi = &ap->link.eh_info;
5798 unsigned long flags;
5802 /* kick EH for boot probing */
5803 spin_lock_irqsave(ap->lock, flags);
5805 ehi->probe_mask |= ATA_ALL_DEVICES;
5806 ehi->action |= ATA_EH_RESET | ATA_EH_LPM;
5807 ehi->flags |= ATA_EHI_NO_AUTOPSY | ATA_EHI_QUIET;
5809 ap->pflags &= ~ATA_PFLAG_INITIALIZING;
5810 ap->pflags |= ATA_PFLAG_LOADING;
5811 ata_port_schedule_eh(ap);
5813 spin_unlock_irqrestore(ap->lock, flags);
5815 /* wait for EH to finish */
5816 ata_port_wait_eh(ap);
5818 DPRINTK("ata%u: bus probe begin\n", ap->print_id);
5819 rc = ata_bus_probe(ap);
5820 DPRINTK("ata%u: bus probe end\n", ap->print_id);
5823 /* FIXME: do something useful here?
5824 * Current libata behavior will
5825 * tear down everything when
5826 * the module is removed
5827 * or the h/w is unplugged.
5833 /* probes are done, now scan each port's disk(s) */
5834 DPRINTK("host probe begin\n");
5835 for (i = 0; i < host->n_ports; i++) {
5836 struct ata_port *ap = host->ports[i];
5838 ata_scsi_scan_host(ap, 1);
5845 * ata_host_activate - start host, request IRQ and register it
5846 * @host: target ATA host
5847 * @irq: IRQ to request
5848 * @irq_handler: irq_handler used when requesting IRQ
5849 * @irq_flags: irq_flags used when requesting IRQ
5850 * @sht: scsi_host_template to use when registering the host
5852 * After allocating an ATA host and initializing it, most libata
5853 * LLDs perform three steps to activate the host - start host,
5854 * request IRQ and register it. This helper takes necessasry
5855 * arguments and performs the three steps in one go.
5857 * An invalid IRQ skips the IRQ registration and expects the host to
5858 * have set polling mode on the port. In this case, @irq_handler
5862 * Inherited from calling layer (may sleep).
5865 * 0 on success, -errno otherwise.
5867 int ata_host_activate(struct ata_host *host, int irq,
5868 irq_handler_t irq_handler, unsigned long irq_flags,
5869 struct scsi_host_template *sht)
5873 rc = ata_host_start(host);
5877 /* Special case for polling mode */
5879 WARN_ON(irq_handler);
5880 return ata_host_register(host, sht);
5883 rc = devm_request_irq(host->dev, irq, irq_handler, irq_flags,
5884 dev_driver_string(host->dev), host);
5888 for (i = 0; i < host->n_ports; i++)
5889 ata_port_desc(host->ports[i], "irq %d", irq);
5891 rc = ata_host_register(host, sht);
5892 /* if failed, just free the IRQ and leave ports alone */
5894 devm_free_irq(host->dev, irq, host);
5900 * ata_port_detach - Detach ATA port in prepration of device removal
5901 * @ap: ATA port to be detached
5903 * Detach all ATA devices and the associated SCSI devices of @ap;
5904 * then, remove the associated SCSI host. @ap is guaranteed to
5905 * be quiescent on return from this function.
5908 * Kernel thread context (may sleep).
5910 static void ata_port_detach(struct ata_port *ap)
5912 unsigned long flags;
5913 struct ata_link *link;
5914 struct ata_device *dev;
5916 if (!ap->ops->error_handler)
5919 /* tell EH we're leaving & flush EH */
5920 spin_lock_irqsave(ap->lock, flags);
5921 ap->pflags |= ATA_PFLAG_UNLOADING;
5922 spin_unlock_irqrestore(ap->lock, flags);
5924 ata_port_wait_eh(ap);
5926 /* EH is now guaranteed to see UNLOADING - EH context belongs
5927 * to us. Restore SControl and disable all existing devices.
5929 __ata_port_for_each_link(link, ap) {
5930 sata_scr_write(link, SCR_CONTROL, link->saved_scontrol);
5931 ata_link_for_each_dev(dev, link)
5932 ata_dev_disable(dev);
5935 /* Final freeze & EH. All in-flight commands are aborted. EH
5936 * will be skipped and retrials will be terminated with bad
5939 spin_lock_irqsave(ap->lock, flags);
5940 ata_port_freeze(ap); /* won't be thawed */
5941 spin_unlock_irqrestore(ap->lock, flags);
5943 ata_port_wait_eh(ap);
5944 cancel_rearming_delayed_work(&ap->hotplug_task);
5947 /* remove the associated SCSI host */
5948 scsi_remove_host(ap->scsi_host);
5952 * ata_host_detach - Detach all ports of an ATA host
5953 * @host: Host to detach
5955 * Detach all ports of @host.
5958 * Kernel thread context (may sleep).
5960 void ata_host_detach(struct ata_host *host)
5964 for (i = 0; i < host->n_ports; i++)
5965 ata_port_detach(host->ports[i]);
5967 /* the host is dead now, dissociate ACPI */
5968 ata_acpi_dissociate(host);
5974 * ata_pci_remove_one - PCI layer callback for device removal
5975 * @pdev: PCI device that was removed
5977 * PCI layer indicates to libata via this hook that hot-unplug or
5978 * module unload event has occurred. Detach all ports. Resource
5979 * release is handled via devres.
5982 * Inherited from PCI layer (may sleep).
5984 void ata_pci_remove_one(struct pci_dev *pdev)
5986 struct device *dev = &pdev->dev;
5987 struct ata_host *host = dev_get_drvdata(dev);
5989 ata_host_detach(host);
5992 /* move to PCI subsystem */
5993 int pci_test_config_bits(struct pci_dev *pdev, const struct pci_bits *bits)
5995 unsigned long tmp = 0;
5997 switch (bits->width) {
6000 pci_read_config_byte(pdev, bits->reg, &tmp8);
6006 pci_read_config_word(pdev, bits->reg, &tmp16);
6012 pci_read_config_dword(pdev, bits->reg, &tmp32);
6023 return (tmp == bits->val) ? 1 : 0;
6027 void ata_pci_device_do_suspend(struct pci_dev *pdev, pm_message_t mesg)
6029 pci_save_state(pdev);
6030 pci_disable_device(pdev);
6032 if (mesg.event & PM_EVENT_SLEEP)
6033 pci_set_power_state(pdev, PCI_D3hot);
6036 int ata_pci_device_do_resume(struct pci_dev *pdev)
6040 pci_set_power_state(pdev, PCI_D0);
6041 pci_restore_state(pdev);
6043 rc = pcim_enable_device(pdev);
6045 dev_printk(KERN_ERR, &pdev->dev,
6046 "failed to enable device after resume (%d)\n", rc);
6050 pci_set_master(pdev);
6054 int ata_pci_device_suspend(struct pci_dev *pdev, pm_message_t mesg)
6056 struct ata_host *host = dev_get_drvdata(&pdev->dev);
6059 rc = ata_host_suspend(host, mesg);
6063 ata_pci_device_do_suspend(pdev, mesg);
6068 int ata_pci_device_resume(struct pci_dev *pdev)
6070 struct ata_host *host = dev_get_drvdata(&pdev->dev);
6073 rc = ata_pci_device_do_resume(pdev);
6075 ata_host_resume(host);
6078 #endif /* CONFIG_PM */
6080 #endif /* CONFIG_PCI */
6082 static int __init ata_parse_force_one(char **cur,
6083 struct ata_force_ent *force_ent,
6084 const char **reason)
6086 /* FIXME: Currently, there's no way to tag init const data and
6087 * using __initdata causes build failure on some versions of
6088 * gcc. Once __initdataconst is implemented, add const to the
6089 * following structure.
6091 static struct ata_force_param force_tbl[] __initdata = {
6092 { "40c", .cbl = ATA_CBL_PATA40 },
6093 { "80c", .cbl = ATA_CBL_PATA80 },
6094 { "short40c", .cbl = ATA_CBL_PATA40_SHORT },
6095 { "unk", .cbl = ATA_CBL_PATA_UNK },
6096 { "ign", .cbl = ATA_CBL_PATA_IGN },
6097 { "sata", .cbl = ATA_CBL_SATA },
6098 { "1.5Gbps", .spd_limit = 1 },
6099 { "3.0Gbps", .spd_limit = 2 },
6100 { "noncq", .horkage_on = ATA_HORKAGE_NONCQ },
6101 { "ncq", .horkage_off = ATA_HORKAGE_NONCQ },
6102 { "pio0", .xfer_mask = 1 << (ATA_SHIFT_PIO + 0) },
6103 { "pio1", .xfer_mask = 1 << (ATA_SHIFT_PIO + 1) },
6104 { "pio2", .xfer_mask = 1 << (ATA_SHIFT_PIO + 2) },
6105 { "pio3", .xfer_mask = 1 << (ATA_SHIFT_PIO + 3) },
6106 { "pio4", .xfer_mask = 1 << (ATA_SHIFT_PIO + 4) },
6107 { "pio5", .xfer_mask = 1 << (ATA_SHIFT_PIO + 5) },
6108 { "pio6", .xfer_mask = 1 << (ATA_SHIFT_PIO + 6) },
6109 { "mwdma0", .xfer_mask = 1 << (ATA_SHIFT_MWDMA + 0) },
6110 { "mwdma1", .xfer_mask = 1 << (ATA_SHIFT_MWDMA + 1) },
6111 { "mwdma2", .xfer_mask = 1 << (ATA_SHIFT_MWDMA + 2) },
6112 { "mwdma3", .xfer_mask = 1 << (ATA_SHIFT_MWDMA + 3) },
6113 { "mwdma4", .xfer_mask = 1 << (ATA_SHIFT_MWDMA + 4) },
6114 { "udma0", .xfer_mask = 1 << (ATA_SHIFT_UDMA + 0) },
6115 { "udma16", .xfer_mask = 1 << (ATA_SHIFT_UDMA + 0) },
6116 { "udma/16", .xfer_mask = 1 << (ATA_SHIFT_UDMA + 0) },
6117 { "udma1", .xfer_mask = 1 << (ATA_SHIFT_UDMA + 1) },
6118 { "udma25", .xfer_mask = 1 << (ATA_SHIFT_UDMA + 1) },
6119 { "udma/25", .xfer_mask = 1 << (ATA_SHIFT_UDMA + 1) },
6120 { "udma2", .xfer_mask = 1 << (ATA_SHIFT_UDMA + 2) },
6121 { "udma33", .xfer_mask = 1 << (ATA_SHIFT_UDMA + 2) },
6122 { "udma/33", .xfer_mask = 1 << (ATA_SHIFT_UDMA + 2) },
6123 { "udma3", .xfer_mask = 1 << (ATA_SHIFT_UDMA + 3) },
6124 { "udma44", .xfer_mask = 1 << (ATA_SHIFT_UDMA + 3) },
6125 { "udma/44", .xfer_mask = 1 << (ATA_SHIFT_UDMA + 3) },
6126 { "udma4", .xfer_mask = 1 << (ATA_SHIFT_UDMA + 4) },
6127 { "udma66", .xfer_mask = 1 << (ATA_SHIFT_UDMA + 4) },
6128 { "udma/66", .xfer_mask = 1 << (ATA_SHIFT_UDMA + 4) },
6129 { "udma5", .xfer_mask = 1 << (ATA_SHIFT_UDMA + 5) },
6130 { "udma100", .xfer_mask = 1 << (ATA_SHIFT_UDMA + 5) },
6131 { "udma/100", .xfer_mask = 1 << (ATA_SHIFT_UDMA + 5) },
6132 { "udma6", .xfer_mask = 1 << (ATA_SHIFT_UDMA + 6) },
6133 { "udma133", .xfer_mask = 1 << (ATA_SHIFT_UDMA + 6) },
6134 { "udma/133", .xfer_mask = 1 << (ATA_SHIFT_UDMA + 6) },
6135 { "udma7", .xfer_mask = 1 << (ATA_SHIFT_UDMA + 7) },
6136 { "nohrst", .lflags = ATA_LFLAG_NO_HRST },
6137 { "nosrst", .lflags = ATA_LFLAG_NO_SRST },
6138 { "norst", .lflags = ATA_LFLAG_NO_HRST | ATA_LFLAG_NO_SRST },
6140 char *start = *cur, *p = *cur;
6141 char *id, *val, *endp;
6142 const struct ata_force_param *match_fp = NULL;
6143 int nr_matches = 0, i;
6145 /* find where this param ends and update *cur */
6146 while (*p != '\0' && *p != ',')
6157 p = strchr(start, ':');
6159 val = strstrip(start);
6164 id = strstrip(start);
6165 val = strstrip(p + 1);
6168 p = strchr(id, '.');
6171 force_ent->device = simple_strtoul(p, &endp, 10);
6172 if (p == endp || *endp != '\0') {
6173 *reason = "invalid device";
6178 force_ent->port = simple_strtoul(id, &endp, 10);
6179 if (p == endp || *endp != '\0') {
6180 *reason = "invalid port/link";
6185 /* parse val, allow shortcuts so that both 1.5 and 1.5Gbps work */
6186 for (i = 0; i < ARRAY_SIZE(force_tbl); i++) {
6187 const struct ata_force_param *fp = &force_tbl[i];
6189 if (strncasecmp(val, fp->name, strlen(val)))
6195 if (strcasecmp(val, fp->name) == 0) {
6202 *reason = "unknown value";
6205 if (nr_matches > 1) {
6206 *reason = "ambigious value";
6210 force_ent->param = *match_fp;
6215 static void __init ata_parse_force_param(void)
6217 int idx = 0, size = 1;
6218 int last_port = -1, last_device = -1;
6219 char *p, *cur, *next;
6221 /* calculate maximum number of params and allocate force_tbl */
6222 for (p = ata_force_param_buf; *p; p++)
6226 ata_force_tbl = kzalloc(sizeof(ata_force_tbl[0]) * size, GFP_KERNEL);
6227 if (!ata_force_tbl) {
6228 printk(KERN_WARNING "ata: failed to extend force table, "
6229 "libata.force ignored\n");
6233 /* parse and populate the table */
6234 for (cur = ata_force_param_buf; *cur != '\0'; cur = next) {
6235 const char *reason = "";
6236 struct ata_force_ent te = { .port = -1, .device = -1 };
6239 if (ata_parse_force_one(&next, &te, &reason)) {
6240 printk(KERN_WARNING "ata: failed to parse force "
6241 "parameter \"%s\" (%s)\n",
6246 if (te.port == -1) {
6247 te.port = last_port;
6248 te.device = last_device;
6251 ata_force_tbl[idx++] = te;
6253 last_port = te.port;
6254 last_device = te.device;
6257 ata_force_tbl_size = idx;
6260 static int __init ata_init(void)
6262 ata_parse_force_param();
6264 ata_wq = create_workqueue("ata");
6266 goto free_force_tbl;
6268 ata_aux_wq = create_singlethread_workqueue("ata_aux");
6272 printk(KERN_DEBUG "libata version " DRV_VERSION " loaded.\n");
6276 destroy_workqueue(ata_wq);
6278 kfree(ata_force_tbl);
6282 static void __exit ata_exit(void)
6284 kfree(ata_force_tbl);
6285 destroy_workqueue(ata_wq);
6286 destroy_workqueue(ata_aux_wq);
6289 subsys_initcall(ata_init);
6290 module_exit(ata_exit);
6292 static unsigned long ratelimit_time;
6293 static DEFINE_SPINLOCK(ata_ratelimit_lock);
6295 int ata_ratelimit(void)
6298 unsigned long flags;
6300 spin_lock_irqsave(&ata_ratelimit_lock, flags);
6302 if (time_after(jiffies, ratelimit_time)) {
6304 ratelimit_time = jiffies + (HZ/5);
6308 spin_unlock_irqrestore(&ata_ratelimit_lock, flags);
6314 * ata_wait_register - wait until register value changes
6315 * @reg: IO-mapped register
6316 * @mask: Mask to apply to read register value
6317 * @val: Wait condition
6318 * @interval: polling interval in milliseconds
6319 * @timeout: timeout in milliseconds
6321 * Waiting for some bits of register to change is a common
6322 * operation for ATA controllers. This function reads 32bit LE
6323 * IO-mapped register @reg and tests for the following condition.
6325 * (*@reg & mask) != val
6327 * If the condition is met, it returns; otherwise, the process is
6328 * repeated after @interval_msec until timeout.
6331 * Kernel thread context (may sleep)
6334 * The final register value.
6336 u32 ata_wait_register(void __iomem *reg, u32 mask, u32 val,
6337 unsigned long interval, unsigned long timeout)
6339 unsigned long deadline;
6342 tmp = ioread32(reg);
6344 /* Calculate timeout _after_ the first read to make sure
6345 * preceding writes reach the controller before starting to
6346 * eat away the timeout.
6348 deadline = ata_deadline(jiffies, timeout);
6350 while ((tmp & mask) == val && time_before(jiffies, deadline)) {
6352 tmp = ioread32(reg);
6361 static unsigned int ata_dummy_qc_issue(struct ata_queued_cmd *qc)
6363 return AC_ERR_SYSTEM;
6366 static void ata_dummy_error_handler(struct ata_port *ap)
6371 struct ata_port_operations ata_dummy_port_ops = {
6372 .qc_prep = ata_noop_qc_prep,
6373 .qc_issue = ata_dummy_qc_issue,
6374 .error_handler = ata_dummy_error_handler,
6377 const struct ata_port_info ata_dummy_port_info = {
6378 .port_ops = &ata_dummy_port_ops,
6382 * libata is essentially a library of internal helper functions for
6383 * low-level ATA host controller drivers. As such, the API/ABI is
6384 * likely to change as new drivers are added and updated.
6385 * Do not depend on ABI/API stability.
6387 EXPORT_SYMBOL_GPL(sata_deb_timing_normal);
6388 EXPORT_SYMBOL_GPL(sata_deb_timing_hotplug);
6389 EXPORT_SYMBOL_GPL(sata_deb_timing_long);
6390 EXPORT_SYMBOL_GPL(ata_base_port_ops);
6391 EXPORT_SYMBOL_GPL(sata_port_ops);
6392 EXPORT_SYMBOL_GPL(ata_dummy_port_ops);
6393 EXPORT_SYMBOL_GPL(ata_dummy_port_info);
6394 EXPORT_SYMBOL_GPL(__ata_port_next_link);
6395 EXPORT_SYMBOL_GPL(ata_std_bios_param);
6396 EXPORT_SYMBOL_GPL(ata_host_init);
6397 EXPORT_SYMBOL_GPL(ata_host_alloc);
6398 EXPORT_SYMBOL_GPL(ata_host_alloc_pinfo);
6399 EXPORT_SYMBOL_GPL(ata_slave_link_init);
6400 EXPORT_SYMBOL_GPL(ata_host_start);
6401 EXPORT_SYMBOL_GPL(ata_host_register);
6402 EXPORT_SYMBOL_GPL(ata_host_activate);
6403 EXPORT_SYMBOL_GPL(ata_host_detach);
6404 EXPORT_SYMBOL_GPL(ata_sg_init);
6405 EXPORT_SYMBOL_GPL(ata_qc_complete);
6406 EXPORT_SYMBOL_GPL(ata_qc_complete_multiple);
6407 EXPORT_SYMBOL_GPL(atapi_cmd_type);
6408 EXPORT_SYMBOL_GPL(ata_tf_to_fis);
6409 EXPORT_SYMBOL_GPL(ata_tf_from_fis);
6410 EXPORT_SYMBOL_GPL(ata_pack_xfermask);
6411 EXPORT_SYMBOL_GPL(ata_unpack_xfermask);
6412 EXPORT_SYMBOL_GPL(ata_xfer_mask2mode);
6413 EXPORT_SYMBOL_GPL(ata_xfer_mode2mask);
6414 EXPORT_SYMBOL_GPL(ata_xfer_mode2shift);
6415 EXPORT_SYMBOL_GPL(ata_mode_string);
6416 EXPORT_SYMBOL_GPL(ata_id_xfermask);
6417 EXPORT_SYMBOL_GPL(ata_port_start);
6418 EXPORT_SYMBOL_GPL(ata_do_set_mode);
6419 EXPORT_SYMBOL_GPL(ata_std_qc_defer);
6420 EXPORT_SYMBOL_GPL(ata_noop_qc_prep);
6421 EXPORT_SYMBOL_GPL(ata_port_probe);
6422 EXPORT_SYMBOL_GPL(ata_dev_disable);
6423 EXPORT_SYMBOL_GPL(sata_set_spd);
6424 EXPORT_SYMBOL_GPL(ata_wait_after_reset);
6425 EXPORT_SYMBOL_GPL(sata_link_debounce);
6426 EXPORT_SYMBOL_GPL(sata_link_resume);
6427 EXPORT_SYMBOL_GPL(ata_std_prereset);
6428 EXPORT_SYMBOL_GPL(sata_link_hardreset);
6429 EXPORT_SYMBOL_GPL(sata_std_hardreset);
6430 EXPORT_SYMBOL_GPL(ata_std_postreset);
6431 EXPORT_SYMBOL_GPL(ata_dev_classify);
6432 EXPORT_SYMBOL_GPL(ata_dev_pair);
6433 EXPORT_SYMBOL_GPL(ata_port_disable);
6434 EXPORT_SYMBOL_GPL(ata_ratelimit);
6435 EXPORT_SYMBOL_GPL(ata_wait_register);
6436 EXPORT_SYMBOL_GPL(ata_scsi_ioctl);
6437 EXPORT_SYMBOL_GPL(ata_scsi_queuecmd);
6438 EXPORT_SYMBOL_GPL(ata_scsi_slave_config);
6439 EXPORT_SYMBOL_GPL(ata_scsi_slave_destroy);
6440 EXPORT_SYMBOL_GPL(ata_scsi_change_queue_depth);
6441 EXPORT_SYMBOL_GPL(sata_scr_valid);
6442 EXPORT_SYMBOL_GPL(sata_scr_read);
6443 EXPORT_SYMBOL_GPL(sata_scr_write);
6444 EXPORT_SYMBOL_GPL(sata_scr_write_flush);
6445 EXPORT_SYMBOL_GPL(ata_link_online);
6446 EXPORT_SYMBOL_GPL(ata_link_offline);
6448 EXPORT_SYMBOL_GPL(ata_host_suspend);
6449 EXPORT_SYMBOL_GPL(ata_host_resume);
6450 #endif /* CONFIG_PM */
6451 EXPORT_SYMBOL_GPL(ata_id_string);
6452 EXPORT_SYMBOL_GPL(ata_id_c_string);
6453 EXPORT_SYMBOL_GPL(ata_do_dev_read_id);
6454 EXPORT_SYMBOL_GPL(ata_scsi_simulate);
6456 EXPORT_SYMBOL_GPL(ata_pio_need_iordy);
6457 EXPORT_SYMBOL_GPL(ata_timing_find_mode);
6458 EXPORT_SYMBOL_GPL(ata_timing_compute);
6459 EXPORT_SYMBOL_GPL(ata_timing_merge);
6460 EXPORT_SYMBOL_GPL(ata_timing_cycle2mode);
6463 EXPORT_SYMBOL_GPL(pci_test_config_bits);
6464 EXPORT_SYMBOL_GPL(ata_pci_remove_one);
6466 EXPORT_SYMBOL_GPL(ata_pci_device_do_suspend);
6467 EXPORT_SYMBOL_GPL(ata_pci_device_do_resume);
6468 EXPORT_SYMBOL_GPL(ata_pci_device_suspend);
6469 EXPORT_SYMBOL_GPL(ata_pci_device_resume);
6470 #endif /* CONFIG_PM */
6471 #endif /* CONFIG_PCI */
6473 EXPORT_SYMBOL_GPL(__ata_ehi_push_desc);
6474 EXPORT_SYMBOL_GPL(ata_ehi_push_desc);
6475 EXPORT_SYMBOL_GPL(ata_ehi_clear_desc);
6476 EXPORT_SYMBOL_GPL(ata_port_desc);
6478 EXPORT_SYMBOL_GPL(ata_port_pbar_desc);
6479 #endif /* CONFIG_PCI */
6480 EXPORT_SYMBOL_GPL(ata_port_schedule_eh);
6481 EXPORT_SYMBOL_GPL(ata_link_abort);
6482 EXPORT_SYMBOL_GPL(ata_port_abort);
6483 EXPORT_SYMBOL_GPL(ata_port_freeze);
6484 EXPORT_SYMBOL_GPL(sata_async_notification);
6485 EXPORT_SYMBOL_GPL(ata_eh_freeze_port);
6486 EXPORT_SYMBOL_GPL(ata_eh_thaw_port);
6487 EXPORT_SYMBOL_GPL(ata_eh_qc_complete);
6488 EXPORT_SYMBOL_GPL(ata_eh_qc_retry);
6489 EXPORT_SYMBOL_GPL(ata_eh_analyze_ncq_error);
6490 EXPORT_SYMBOL_GPL(ata_do_eh);
6491 EXPORT_SYMBOL_GPL(ata_std_error_handler);
6493 EXPORT_SYMBOL_GPL(ata_cable_40wire);
6494 EXPORT_SYMBOL_GPL(ata_cable_80wire);
6495 EXPORT_SYMBOL_GPL(ata_cable_unknown);
6496 EXPORT_SYMBOL_GPL(ata_cable_ignore);
6497 EXPORT_SYMBOL_GPL(ata_cable_sata);