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/highmem.h>
50 #include <linux/spinlock.h>
51 #include <linux/blkdev.h>
52 #include <linux/delay.h>
53 #include <linux/timer.h>
54 #include <linux/interrupt.h>
55 #include <linux/completion.h>
56 #include <linux/suspend.h>
57 #include <linux/workqueue.h>
58 #include <linux/jiffies.h>
59 #include <linux/scatterlist.h>
61 #include <scsi/scsi.h>
62 #include <scsi/scsi_cmnd.h>
63 #include <scsi/scsi_host.h>
64 #include <linux/libata.h>
65 #include <asm/semaphore.h>
66 #include <asm/byteorder.h>
67 #include <linux/cdrom.h>
72 /* debounce timing parameters in msecs { interval, duration, timeout } */
73 const unsigned long sata_deb_timing_normal[] = { 5, 100, 2000 };
74 const unsigned long sata_deb_timing_hotplug[] = { 25, 500, 2000 };
75 const unsigned long sata_deb_timing_long[] = { 100, 2000, 5000 };
77 static unsigned int ata_dev_init_params(struct ata_device *dev,
78 u16 heads, u16 sectors);
79 static unsigned int ata_dev_set_xfermode(struct ata_device *dev);
80 static unsigned int ata_dev_set_feature(struct ata_device *dev,
81 u8 enable, u8 feature);
82 static void ata_dev_xfermask(struct ata_device *dev);
83 static unsigned long ata_dev_blacklisted(const struct ata_device *dev);
85 unsigned int ata_print_id = 1;
86 static struct workqueue_struct *ata_wq;
88 struct workqueue_struct *ata_aux_wq;
90 int atapi_enabled = 1;
91 module_param(atapi_enabled, int, 0444);
92 MODULE_PARM_DESC(atapi_enabled, "Enable discovery of ATAPI devices (0=off, 1=on)");
95 module_param(atapi_dmadir, int, 0444);
96 MODULE_PARM_DESC(atapi_dmadir, "Enable ATAPI DMADIR bridge support (0=off, 1=on)");
98 int atapi_passthru16 = 1;
99 module_param(atapi_passthru16, int, 0444);
100 MODULE_PARM_DESC(atapi_passthru16, "Enable ATA_16 passthru for ATAPI devices; on by default (0=off, 1=on)");
103 module_param_named(fua, libata_fua, int, 0444);
104 MODULE_PARM_DESC(fua, "FUA support (0=off, 1=on)");
106 static int ata_ignore_hpa;
107 module_param_named(ignore_hpa, ata_ignore_hpa, int, 0644);
108 MODULE_PARM_DESC(ignore_hpa, "Ignore HPA limit (0=keep BIOS limits, 1=ignore limits, using full disk)");
110 static int libata_dma_mask = ATA_DMA_MASK_ATA|ATA_DMA_MASK_ATAPI|ATA_DMA_MASK_CFA;
111 module_param_named(dma, libata_dma_mask, int, 0444);
112 MODULE_PARM_DESC(dma, "DMA enable/disable (0x1==ATA, 0x2==ATAPI, 0x4==CF)");
114 static int ata_probe_timeout = ATA_TMOUT_INTERNAL / HZ;
115 module_param(ata_probe_timeout, int, 0444);
116 MODULE_PARM_DESC(ata_probe_timeout, "Set ATA probing timeout (seconds)");
118 int libata_noacpi = 0;
119 module_param_named(noacpi, libata_noacpi, int, 0444);
120 MODULE_PARM_DESC(noacpi, "Disables the use of ACPI in probe/suspend/resume when set");
122 int libata_allow_tpm = 0;
123 module_param_named(allow_tpm, libata_allow_tpm, int, 0444);
124 MODULE_PARM_DESC(allow_tpm, "Permit the use of TPM commands");
126 MODULE_AUTHOR("Jeff Garzik");
127 MODULE_DESCRIPTION("Library module for ATA devices");
128 MODULE_LICENSE("GPL");
129 MODULE_VERSION(DRV_VERSION);
133 * ata_tf_to_fis - Convert ATA taskfile to SATA FIS structure
134 * @tf: Taskfile to convert
135 * @pmp: Port multiplier port
136 * @is_cmd: This FIS is for command
137 * @fis: Buffer into which data will output
139 * Converts a standard ATA taskfile to a Serial ATA
140 * FIS structure (Register - Host to Device).
143 * Inherited from caller.
145 void ata_tf_to_fis(const struct ata_taskfile *tf, u8 pmp, int is_cmd, u8 *fis)
147 fis[0] = 0x27; /* Register - Host to Device FIS */
148 fis[1] = pmp & 0xf; /* Port multiplier number*/
150 fis[1] |= (1 << 7); /* bit 7 indicates Command FIS */
152 fis[2] = tf->command;
153 fis[3] = tf->feature;
160 fis[8] = tf->hob_lbal;
161 fis[9] = tf->hob_lbam;
162 fis[10] = tf->hob_lbah;
163 fis[11] = tf->hob_feature;
166 fis[13] = tf->hob_nsect;
177 * ata_tf_from_fis - Convert SATA FIS to ATA taskfile
178 * @fis: Buffer from which data will be input
179 * @tf: Taskfile to output
181 * Converts a serial ATA FIS structure to a standard ATA taskfile.
184 * Inherited from caller.
187 void ata_tf_from_fis(const u8 *fis, struct ata_taskfile *tf)
189 tf->command = fis[2]; /* status */
190 tf->feature = fis[3]; /* error */
197 tf->hob_lbal = fis[8];
198 tf->hob_lbam = fis[9];
199 tf->hob_lbah = fis[10];
202 tf->hob_nsect = fis[13];
205 static const u8 ata_rw_cmds[] = {
209 ATA_CMD_READ_MULTI_EXT,
210 ATA_CMD_WRITE_MULTI_EXT,
214 ATA_CMD_WRITE_MULTI_FUA_EXT,
218 ATA_CMD_PIO_READ_EXT,
219 ATA_CMD_PIO_WRITE_EXT,
232 ATA_CMD_WRITE_FUA_EXT
236 * ata_rwcmd_protocol - set taskfile r/w commands and protocol
237 * @tf: command to examine and configure
238 * @dev: device tf belongs to
240 * Examine the device configuration and tf->flags to calculate
241 * the proper read/write commands and protocol to use.
246 static int ata_rwcmd_protocol(struct ata_taskfile *tf, struct ata_device *dev)
250 int index, fua, lba48, write;
252 fua = (tf->flags & ATA_TFLAG_FUA) ? 4 : 0;
253 lba48 = (tf->flags & ATA_TFLAG_LBA48) ? 2 : 0;
254 write = (tf->flags & ATA_TFLAG_WRITE) ? 1 : 0;
256 if (dev->flags & ATA_DFLAG_PIO) {
257 tf->protocol = ATA_PROT_PIO;
258 index = dev->multi_count ? 0 : 8;
259 } else if (lba48 && (dev->link->ap->flags & ATA_FLAG_PIO_LBA48)) {
260 /* Unable to use DMA due to host limitation */
261 tf->protocol = ATA_PROT_PIO;
262 index = dev->multi_count ? 0 : 8;
264 tf->protocol = ATA_PROT_DMA;
268 cmd = ata_rw_cmds[index + fua + lba48 + write];
277 * ata_tf_read_block - Read block address from ATA taskfile
278 * @tf: ATA taskfile of interest
279 * @dev: ATA device @tf belongs to
284 * Read block address from @tf. This function can handle all
285 * three address formats - LBA, LBA48 and CHS. tf->protocol and
286 * flags select the address format to use.
289 * Block address read from @tf.
291 u64 ata_tf_read_block(struct ata_taskfile *tf, struct ata_device *dev)
295 if (tf->flags & ATA_TFLAG_LBA) {
296 if (tf->flags & ATA_TFLAG_LBA48) {
297 block |= (u64)tf->hob_lbah << 40;
298 block |= (u64)tf->hob_lbam << 32;
299 block |= tf->hob_lbal << 24;
301 block |= (tf->device & 0xf) << 24;
303 block |= tf->lbah << 16;
304 block |= tf->lbam << 8;
309 cyl = tf->lbam | (tf->lbah << 8);
310 head = tf->device & 0xf;
313 block = (cyl * dev->heads + head) * dev->sectors + sect;
320 * ata_build_rw_tf - Build ATA taskfile for given read/write request
321 * @tf: Target ATA taskfile
322 * @dev: ATA device @tf belongs to
323 * @block: Block address
324 * @n_block: Number of blocks
325 * @tf_flags: RW/FUA etc...
331 * Build ATA taskfile @tf for read/write request described by
332 * @block, @n_block, @tf_flags and @tag on @dev.
336 * 0 on success, -ERANGE if the request is too large for @dev,
337 * -EINVAL if the request is invalid.
339 int ata_build_rw_tf(struct ata_taskfile *tf, struct ata_device *dev,
340 u64 block, u32 n_block, unsigned int tf_flags,
343 tf->flags |= ATA_TFLAG_ISADDR | ATA_TFLAG_DEVICE;
344 tf->flags |= tf_flags;
346 if (ata_ncq_enabled(dev) && likely(tag != ATA_TAG_INTERNAL)) {
348 if (!lba_48_ok(block, n_block))
351 tf->protocol = ATA_PROT_NCQ;
352 tf->flags |= ATA_TFLAG_LBA | ATA_TFLAG_LBA48;
354 if (tf->flags & ATA_TFLAG_WRITE)
355 tf->command = ATA_CMD_FPDMA_WRITE;
357 tf->command = ATA_CMD_FPDMA_READ;
359 tf->nsect = tag << 3;
360 tf->hob_feature = (n_block >> 8) & 0xff;
361 tf->feature = n_block & 0xff;
363 tf->hob_lbah = (block >> 40) & 0xff;
364 tf->hob_lbam = (block >> 32) & 0xff;
365 tf->hob_lbal = (block >> 24) & 0xff;
366 tf->lbah = (block >> 16) & 0xff;
367 tf->lbam = (block >> 8) & 0xff;
368 tf->lbal = block & 0xff;
371 if (tf->flags & ATA_TFLAG_FUA)
372 tf->device |= 1 << 7;
373 } else if (dev->flags & ATA_DFLAG_LBA) {
374 tf->flags |= ATA_TFLAG_LBA;
376 if (lba_28_ok(block, n_block)) {
378 tf->device |= (block >> 24) & 0xf;
379 } else if (lba_48_ok(block, n_block)) {
380 if (!(dev->flags & ATA_DFLAG_LBA48))
384 tf->flags |= ATA_TFLAG_LBA48;
386 tf->hob_nsect = (n_block >> 8) & 0xff;
388 tf->hob_lbah = (block >> 40) & 0xff;
389 tf->hob_lbam = (block >> 32) & 0xff;
390 tf->hob_lbal = (block >> 24) & 0xff;
392 /* request too large even for LBA48 */
395 if (unlikely(ata_rwcmd_protocol(tf, dev) < 0))
398 tf->nsect = n_block & 0xff;
400 tf->lbah = (block >> 16) & 0xff;
401 tf->lbam = (block >> 8) & 0xff;
402 tf->lbal = block & 0xff;
404 tf->device |= ATA_LBA;
407 u32 sect, head, cyl, track;
409 /* The request -may- be too large for CHS addressing. */
410 if (!lba_28_ok(block, n_block))
413 if (unlikely(ata_rwcmd_protocol(tf, dev) < 0))
416 /* Convert LBA to CHS */
417 track = (u32)block / dev->sectors;
418 cyl = track / dev->heads;
419 head = track % dev->heads;
420 sect = (u32)block % dev->sectors + 1;
422 DPRINTK("block %u track %u cyl %u head %u sect %u\n",
423 (u32)block, track, cyl, head, sect);
425 /* Check whether the converted CHS can fit.
429 if ((cyl >> 16) || (head >> 4) || (sect >> 8) || (!sect))
432 tf->nsect = n_block & 0xff; /* Sector count 0 means 256 sectors */
443 * ata_pack_xfermask - Pack pio, mwdma and udma masks into xfer_mask
444 * @pio_mask: pio_mask
445 * @mwdma_mask: mwdma_mask
446 * @udma_mask: udma_mask
448 * Pack @pio_mask, @mwdma_mask and @udma_mask into a single
449 * unsigned int xfer_mask.
457 unsigned long ata_pack_xfermask(unsigned long pio_mask,
458 unsigned long mwdma_mask,
459 unsigned long udma_mask)
461 return ((pio_mask << ATA_SHIFT_PIO) & ATA_MASK_PIO) |
462 ((mwdma_mask << ATA_SHIFT_MWDMA) & ATA_MASK_MWDMA) |
463 ((udma_mask << ATA_SHIFT_UDMA) & ATA_MASK_UDMA);
467 * ata_unpack_xfermask - Unpack xfer_mask into pio, mwdma and udma masks
468 * @xfer_mask: xfer_mask to unpack
469 * @pio_mask: resulting pio_mask
470 * @mwdma_mask: resulting mwdma_mask
471 * @udma_mask: resulting udma_mask
473 * Unpack @xfer_mask into @pio_mask, @mwdma_mask and @udma_mask.
474 * Any NULL distination masks will be ignored.
476 void ata_unpack_xfermask(unsigned long xfer_mask, unsigned long *pio_mask,
477 unsigned long *mwdma_mask, unsigned long *udma_mask)
480 *pio_mask = (xfer_mask & ATA_MASK_PIO) >> ATA_SHIFT_PIO;
482 *mwdma_mask = (xfer_mask & ATA_MASK_MWDMA) >> ATA_SHIFT_MWDMA;
484 *udma_mask = (xfer_mask & ATA_MASK_UDMA) >> ATA_SHIFT_UDMA;
487 static const struct ata_xfer_ent {
491 { ATA_SHIFT_PIO, ATA_NR_PIO_MODES, XFER_PIO_0 },
492 { ATA_SHIFT_MWDMA, ATA_NR_MWDMA_MODES, XFER_MW_DMA_0 },
493 { ATA_SHIFT_UDMA, ATA_NR_UDMA_MODES, XFER_UDMA_0 },
498 * ata_xfer_mask2mode - Find matching XFER_* for the given xfer_mask
499 * @xfer_mask: xfer_mask of interest
501 * Return matching XFER_* value for @xfer_mask. Only the highest
502 * bit of @xfer_mask is considered.
508 * Matching XFER_* value, 0xff if no match found.
510 u8 ata_xfer_mask2mode(unsigned long xfer_mask)
512 int highbit = fls(xfer_mask) - 1;
513 const struct ata_xfer_ent *ent;
515 for (ent = ata_xfer_tbl; ent->shift >= 0; ent++)
516 if (highbit >= ent->shift && highbit < ent->shift + ent->bits)
517 return ent->base + highbit - ent->shift;
522 * ata_xfer_mode2mask - Find matching xfer_mask for XFER_*
523 * @xfer_mode: XFER_* of interest
525 * Return matching xfer_mask for @xfer_mode.
531 * Matching xfer_mask, 0 if no match found.
533 unsigned long ata_xfer_mode2mask(u8 xfer_mode)
535 const struct ata_xfer_ent *ent;
537 for (ent = ata_xfer_tbl; ent->shift >= 0; ent++)
538 if (xfer_mode >= ent->base && xfer_mode < ent->base + ent->bits)
539 return ((2 << (ent->shift + xfer_mode - ent->base)) - 1)
540 & ~((1 << ent->shift) - 1);
545 * ata_xfer_mode2shift - Find matching xfer_shift for XFER_*
546 * @xfer_mode: XFER_* of interest
548 * Return matching xfer_shift for @xfer_mode.
554 * Matching xfer_shift, -1 if no match found.
556 int ata_xfer_mode2shift(unsigned long xfer_mode)
558 const struct ata_xfer_ent *ent;
560 for (ent = ata_xfer_tbl; ent->shift >= 0; ent++)
561 if (xfer_mode >= ent->base && xfer_mode < ent->base + ent->bits)
567 * ata_mode_string - convert xfer_mask to string
568 * @xfer_mask: mask of bits supported; only highest bit counts.
570 * Determine string which represents the highest speed
571 * (highest bit in @modemask).
577 * Constant C string representing highest speed listed in
578 * @mode_mask, or the constant C string "<n/a>".
580 const char *ata_mode_string(unsigned long xfer_mask)
582 static const char * const xfer_mode_str[] = {
606 highbit = fls(xfer_mask) - 1;
607 if (highbit >= 0 && highbit < ARRAY_SIZE(xfer_mode_str))
608 return xfer_mode_str[highbit];
612 static const char *sata_spd_string(unsigned int spd)
614 static const char * const spd_str[] = {
619 if (spd == 0 || (spd - 1) >= ARRAY_SIZE(spd_str))
621 return spd_str[spd - 1];
624 void ata_dev_disable(struct ata_device *dev)
626 if (ata_dev_enabled(dev)) {
627 if (ata_msg_drv(dev->link->ap))
628 ata_dev_printk(dev, KERN_WARNING, "disabled\n");
629 ata_acpi_on_disable(dev);
630 ata_down_xfermask_limit(dev, ATA_DNXFER_FORCE_PIO0 |
636 static int ata_dev_set_dipm(struct ata_device *dev, enum link_pm policy)
638 struct ata_link *link = dev->link;
639 struct ata_port *ap = link->ap;
641 unsigned int err_mask;
645 * disallow DIPM for drivers which haven't set
646 * ATA_FLAG_IPM. This is because when DIPM is enabled,
647 * phy ready will be set in the interrupt status on
648 * state changes, which will cause some drivers to
649 * think there are errors - additionally drivers will
650 * need to disable hot plug.
652 if (!(ap->flags & ATA_FLAG_IPM) || !ata_dev_enabled(dev)) {
653 ap->pm_policy = NOT_AVAILABLE;
658 * For DIPM, we will only enable it for the
661 * Why? Because Disks are too stupid to know that
662 * If the host rejects a request to go to SLUMBER
663 * they should retry at PARTIAL, and instead it
664 * just would give up. So, for medium_power to
665 * work at all, we need to only allow HIPM.
667 rc = sata_scr_read(link, SCR_CONTROL, &scontrol);
673 /* no restrictions on IPM transitions */
674 scontrol &= ~(0x3 << 8);
675 rc = sata_scr_write(link, SCR_CONTROL, scontrol);
680 if (dev->flags & ATA_DFLAG_DIPM)
681 err_mask = ata_dev_set_feature(dev,
682 SETFEATURES_SATA_ENABLE, SATA_DIPM);
685 /* allow IPM to PARTIAL */
686 scontrol &= ~(0x1 << 8);
687 scontrol |= (0x2 << 8);
688 rc = sata_scr_write(link, SCR_CONTROL, scontrol);
693 * we don't have to disable DIPM since IPM flags
694 * disallow transitions to SLUMBER, which effectively
695 * disable DIPM if it does not support PARTIAL
699 case MAX_PERFORMANCE:
700 /* disable all IPM transitions */
701 scontrol |= (0x3 << 8);
702 rc = sata_scr_write(link, SCR_CONTROL, scontrol);
707 * we don't have to disable DIPM since IPM flags
708 * disallow all transitions which effectively
709 * disable DIPM anyway.
714 /* FIXME: handle SET FEATURES failure */
721 * ata_dev_enable_pm - enable SATA interface power management
722 * @dev: device to enable power management
723 * @policy: the link power management policy
725 * Enable SATA Interface power management. This will enable
726 * Device Interface Power Management (DIPM) for min_power
727 * policy, and then call driver specific callbacks for
728 * enabling Host Initiated Power management.
731 * Returns: -EINVAL if IPM is not supported, 0 otherwise.
733 void ata_dev_enable_pm(struct ata_device *dev, enum link_pm policy)
736 struct ata_port *ap = dev->link->ap;
738 /* set HIPM first, then DIPM */
739 if (ap->ops->enable_pm)
740 rc = ap->ops->enable_pm(ap, policy);
743 rc = ata_dev_set_dipm(dev, policy);
747 ap->pm_policy = MAX_PERFORMANCE;
749 ap->pm_policy = policy;
750 return /* rc */; /* hopefully we can use 'rc' eventually */
755 * ata_dev_disable_pm - disable SATA interface power management
756 * @dev: device to disable power management
758 * Disable SATA Interface power management. This will disable
759 * Device Interface Power Management (DIPM) without changing
760 * policy, call driver specific callbacks for disabling Host
761 * Initiated Power management.
766 static void ata_dev_disable_pm(struct ata_device *dev)
768 struct ata_port *ap = dev->link->ap;
770 ata_dev_set_dipm(dev, MAX_PERFORMANCE);
771 if (ap->ops->disable_pm)
772 ap->ops->disable_pm(ap);
774 #endif /* CONFIG_PM */
776 void ata_lpm_schedule(struct ata_port *ap, enum link_pm policy)
778 ap->pm_policy = policy;
779 ap->link.eh_info.action |= ATA_EHI_LPM;
780 ap->link.eh_info.flags |= ATA_EHI_NO_AUTOPSY;
781 ata_port_schedule_eh(ap);
785 static void ata_lpm_enable(struct ata_host *host)
787 struct ata_link *link;
789 struct ata_device *dev;
792 for (i = 0; i < host->n_ports; i++) {
794 ata_port_for_each_link(link, ap) {
795 ata_link_for_each_dev(dev, link)
796 ata_dev_disable_pm(dev);
801 static void ata_lpm_disable(struct ata_host *host)
805 for (i = 0; i < host->n_ports; i++) {
806 struct ata_port *ap = host->ports[i];
807 ata_lpm_schedule(ap, ap->pm_policy);
810 #endif /* CONFIG_PM */
814 * ata_devchk - PATA device presence detection
815 * @ap: ATA channel to examine
816 * @device: Device to examine (starting at zero)
818 * This technique was originally described in
819 * Hale Landis's ATADRVR (www.ata-atapi.com), and
820 * later found its way into the ATA/ATAPI spec.
822 * Write a pattern to the ATA shadow registers,
823 * and if a device is present, it will respond by
824 * correctly storing and echoing back the
825 * ATA shadow register contents.
831 static unsigned int ata_devchk(struct ata_port *ap, unsigned int device)
833 struct ata_ioports *ioaddr = &ap->ioaddr;
836 ap->ops->dev_select(ap, device);
838 iowrite8(0x55, ioaddr->nsect_addr);
839 iowrite8(0xaa, ioaddr->lbal_addr);
841 iowrite8(0xaa, ioaddr->nsect_addr);
842 iowrite8(0x55, ioaddr->lbal_addr);
844 iowrite8(0x55, ioaddr->nsect_addr);
845 iowrite8(0xaa, ioaddr->lbal_addr);
847 nsect = ioread8(ioaddr->nsect_addr);
848 lbal = ioread8(ioaddr->lbal_addr);
850 if ((nsect == 0x55) && (lbal == 0xaa))
851 return 1; /* we found a device */
853 return 0; /* nothing found */
857 * ata_dev_classify - determine device type based on ATA-spec signature
858 * @tf: ATA taskfile register set for device to be identified
860 * Determine from taskfile register contents whether a device is
861 * ATA or ATAPI, as per "Signature and persistence" section
862 * of ATA/PI spec (volume 1, sect 5.14).
868 * Device type, %ATA_DEV_ATA, %ATA_DEV_ATAPI, %ATA_DEV_PMP or
869 * %ATA_DEV_UNKNOWN the event of failure.
871 unsigned int ata_dev_classify(const struct ata_taskfile *tf)
873 /* Apple's open source Darwin code hints that some devices only
874 * put a proper signature into the LBA mid/high registers,
875 * So, we only check those. It's sufficient for uniqueness.
877 * ATA/ATAPI-7 (d1532v1r1: Feb. 19, 2003) specified separate
878 * signatures for ATA and ATAPI devices attached on SerialATA,
879 * 0x3c/0xc3 and 0x69/0x96 respectively. However, SerialATA
880 * spec has never mentioned about using different signatures
881 * for ATA/ATAPI devices. Then, Serial ATA II: Port
882 * Multiplier specification began to use 0x69/0x96 to identify
883 * port multpliers and 0x3c/0xc3 to identify SEMB device.
884 * ATA/ATAPI-7 dropped descriptions about 0x3c/0xc3 and
885 * 0x69/0x96 shortly and described them as reserved for
888 * We follow the current spec and consider that 0x69/0x96
889 * identifies a port multiplier and 0x3c/0xc3 a SEMB device.
891 if ((tf->lbam == 0) && (tf->lbah == 0)) {
892 DPRINTK("found ATA device by sig\n");
896 if ((tf->lbam == 0x14) && (tf->lbah == 0xeb)) {
897 DPRINTK("found ATAPI device by sig\n");
898 return ATA_DEV_ATAPI;
901 if ((tf->lbam == 0x69) && (tf->lbah == 0x96)) {
902 DPRINTK("found PMP device by sig\n");
906 if ((tf->lbam == 0x3c) && (tf->lbah == 0xc3)) {
907 printk(KERN_INFO "ata: SEMB device ignored\n");
908 return ATA_DEV_SEMB_UNSUP; /* not yet */
911 DPRINTK("unknown device\n");
912 return ATA_DEV_UNKNOWN;
916 * ata_dev_try_classify - Parse returned ATA device signature
917 * @dev: ATA device to classify (starting at zero)
918 * @present: device seems present
919 * @r_err: Value of error register on completion
921 * After an event -- SRST, E.D.D., or SATA COMRESET -- occurs,
922 * an ATA/ATAPI-defined set of values is placed in the ATA
923 * shadow registers, indicating the results of device detection
926 * Select the ATA device, and read the values from the ATA shadow
927 * registers. Then parse according to the Error register value,
928 * and the spec-defined values examined by ata_dev_classify().
934 * Device type - %ATA_DEV_ATA, %ATA_DEV_ATAPI or %ATA_DEV_NONE.
936 unsigned int ata_dev_try_classify(struct ata_device *dev, int present,
939 struct ata_port *ap = dev->link->ap;
940 struct ata_taskfile tf;
944 ap->ops->dev_select(ap, dev->devno);
946 memset(&tf, 0, sizeof(tf));
948 ap->ops->tf_read(ap, &tf);
953 /* see if device passed diags: if master then continue and warn later */
954 if (err == 0 && dev->devno == 0)
955 /* diagnostic fail : do nothing _YET_ */
956 dev->horkage |= ATA_HORKAGE_DIAGNOSTIC;
959 else if ((dev->devno == 0) && (err == 0x81))
964 /* determine if device is ATA or ATAPI */
965 class = ata_dev_classify(&tf);
967 if (class == ATA_DEV_UNKNOWN) {
968 /* If the device failed diagnostic, it's likely to
969 * have reported incorrect device signature too.
970 * Assume ATA device if the device seems present but
971 * device signature is invalid with diagnostic
974 if (present && (dev->horkage & ATA_HORKAGE_DIAGNOSTIC))
977 class = ATA_DEV_NONE;
978 } else if ((class == ATA_DEV_ATA) && (ata_chk_status(ap) == 0))
979 class = ATA_DEV_NONE;
985 * ata_id_string - Convert IDENTIFY DEVICE page into string
986 * @id: IDENTIFY DEVICE results we will examine
987 * @s: string into which data is output
988 * @ofs: offset into identify device page
989 * @len: length of string to return. must be an even number.
991 * The strings in the IDENTIFY DEVICE page are broken up into
992 * 16-bit chunks. Run through the string, and output each
993 * 8-bit chunk linearly, regardless of platform.
999 void ata_id_string(const u16 *id, unsigned char *s,
1000 unsigned int ofs, unsigned int len)
1019 * ata_id_c_string - Convert IDENTIFY DEVICE page into C string
1020 * @id: IDENTIFY DEVICE results we will examine
1021 * @s: string into which data is output
1022 * @ofs: offset into identify device page
1023 * @len: length of string to return. must be an odd number.
1025 * This function is identical to ata_id_string except that it
1026 * trims trailing spaces and terminates the resulting string with
1027 * null. @len must be actual maximum length (even number) + 1.
1032 void ata_id_c_string(const u16 *id, unsigned char *s,
1033 unsigned int ofs, unsigned int len)
1037 WARN_ON(!(len & 1));
1039 ata_id_string(id, s, ofs, len - 1);
1041 p = s + strnlen(s, len - 1);
1042 while (p > s && p[-1] == ' ')
1047 static u64 ata_id_n_sectors(const u16 *id)
1049 if (ata_id_has_lba(id)) {
1050 if (ata_id_has_lba48(id))
1051 return ata_id_u64(id, 100);
1053 return ata_id_u32(id, 60);
1055 if (ata_id_current_chs_valid(id))
1056 return ata_id_u32(id, 57);
1058 return id[1] * id[3] * id[6];
1062 static u64 ata_tf_to_lba48(struct ata_taskfile *tf)
1066 sectors |= ((u64)(tf->hob_lbah & 0xff)) << 40;
1067 sectors |= ((u64)(tf->hob_lbam & 0xff)) << 32;
1068 sectors |= (tf->hob_lbal & 0xff) << 24;
1069 sectors |= (tf->lbah & 0xff) << 16;
1070 sectors |= (tf->lbam & 0xff) << 8;
1071 sectors |= (tf->lbal & 0xff);
1076 static u64 ata_tf_to_lba(struct ata_taskfile *tf)
1080 sectors |= (tf->device & 0x0f) << 24;
1081 sectors |= (tf->lbah & 0xff) << 16;
1082 sectors |= (tf->lbam & 0xff) << 8;
1083 sectors |= (tf->lbal & 0xff);
1089 * ata_read_native_max_address - Read native max address
1090 * @dev: target device
1091 * @max_sectors: out parameter for the result native max address
1093 * Perform an LBA48 or LBA28 native size query upon the device in
1097 * 0 on success, -EACCES if command is aborted by the drive.
1098 * -EIO on other errors.
1100 static int ata_read_native_max_address(struct ata_device *dev, u64 *max_sectors)
1102 unsigned int err_mask;
1103 struct ata_taskfile tf;
1104 int lba48 = ata_id_has_lba48(dev->id);
1106 ata_tf_init(dev, &tf);
1108 /* always clear all address registers */
1109 tf.flags |= ATA_TFLAG_DEVICE | ATA_TFLAG_ISADDR;
1112 tf.command = ATA_CMD_READ_NATIVE_MAX_EXT;
1113 tf.flags |= ATA_TFLAG_LBA48;
1115 tf.command = ATA_CMD_READ_NATIVE_MAX;
1117 tf.protocol |= ATA_PROT_NODATA;
1118 tf.device |= ATA_LBA;
1120 err_mask = ata_exec_internal(dev, &tf, NULL, DMA_NONE, NULL, 0, 0);
1122 ata_dev_printk(dev, KERN_WARNING, "failed to read native "
1123 "max address (err_mask=0x%x)\n", err_mask);
1124 if (err_mask == AC_ERR_DEV && (tf.feature & ATA_ABORTED))
1130 *max_sectors = ata_tf_to_lba48(&tf);
1132 *max_sectors = ata_tf_to_lba(&tf);
1133 if (dev->horkage & ATA_HORKAGE_HPA_SIZE)
1139 * ata_set_max_sectors - Set max sectors
1140 * @dev: target device
1141 * @new_sectors: new max sectors value to set for the device
1143 * Set max sectors of @dev to @new_sectors.
1146 * 0 on success, -EACCES if command is aborted or denied (due to
1147 * previous non-volatile SET_MAX) by the drive. -EIO on other
1150 static int ata_set_max_sectors(struct ata_device *dev, u64 new_sectors)
1152 unsigned int err_mask;
1153 struct ata_taskfile tf;
1154 int lba48 = ata_id_has_lba48(dev->id);
1158 ata_tf_init(dev, &tf);
1160 tf.flags |= ATA_TFLAG_DEVICE | ATA_TFLAG_ISADDR;
1163 tf.command = ATA_CMD_SET_MAX_EXT;
1164 tf.flags |= ATA_TFLAG_LBA48;
1166 tf.hob_lbal = (new_sectors >> 24) & 0xff;
1167 tf.hob_lbam = (new_sectors >> 32) & 0xff;
1168 tf.hob_lbah = (new_sectors >> 40) & 0xff;
1170 tf.command = ATA_CMD_SET_MAX;
1172 tf.device |= (new_sectors >> 24) & 0xf;
1175 tf.protocol |= ATA_PROT_NODATA;
1176 tf.device |= ATA_LBA;
1178 tf.lbal = (new_sectors >> 0) & 0xff;
1179 tf.lbam = (new_sectors >> 8) & 0xff;
1180 tf.lbah = (new_sectors >> 16) & 0xff;
1182 err_mask = ata_exec_internal(dev, &tf, NULL, DMA_NONE, NULL, 0, 0);
1184 ata_dev_printk(dev, KERN_WARNING, "failed to set "
1185 "max address (err_mask=0x%x)\n", err_mask);
1186 if (err_mask == AC_ERR_DEV &&
1187 (tf.feature & (ATA_ABORTED | ATA_IDNF)))
1196 * ata_hpa_resize - Resize a device with an HPA set
1197 * @dev: Device to resize
1199 * Read the size of an LBA28 or LBA48 disk with HPA features and resize
1200 * it if required to the full size of the media. The caller must check
1201 * the drive has the HPA feature set enabled.
1204 * 0 on success, -errno on failure.
1206 static int ata_hpa_resize(struct ata_device *dev)
1208 struct ata_eh_context *ehc = &dev->link->eh_context;
1209 int print_info = ehc->i.flags & ATA_EHI_PRINTINFO;
1210 u64 sectors = ata_id_n_sectors(dev->id);
1214 /* do we need to do it? */
1215 if (dev->class != ATA_DEV_ATA ||
1216 !ata_id_has_lba(dev->id) || !ata_id_hpa_enabled(dev->id) ||
1217 (dev->horkage & ATA_HORKAGE_BROKEN_HPA))
1220 /* read native max address */
1221 rc = ata_read_native_max_address(dev, &native_sectors);
1223 /* If HPA isn't going to be unlocked, skip HPA
1224 * resizing from the next try.
1226 if (!ata_ignore_hpa) {
1227 ata_dev_printk(dev, KERN_WARNING, "HPA support seems "
1228 "broken, will skip HPA handling\n");
1229 dev->horkage |= ATA_HORKAGE_BROKEN_HPA;
1231 /* we can continue if device aborted the command */
1239 /* nothing to do? */
1240 if (native_sectors <= sectors || !ata_ignore_hpa) {
1241 if (!print_info || native_sectors == sectors)
1244 if (native_sectors > sectors)
1245 ata_dev_printk(dev, KERN_INFO,
1246 "HPA detected: current %llu, native %llu\n",
1247 (unsigned long long)sectors,
1248 (unsigned long long)native_sectors);
1249 else if (native_sectors < sectors)
1250 ata_dev_printk(dev, KERN_WARNING,
1251 "native sectors (%llu) is smaller than "
1253 (unsigned long long)native_sectors,
1254 (unsigned long long)sectors);
1258 /* let's unlock HPA */
1259 rc = ata_set_max_sectors(dev, native_sectors);
1260 if (rc == -EACCES) {
1261 /* if device aborted the command, skip HPA resizing */
1262 ata_dev_printk(dev, KERN_WARNING, "device aborted resize "
1263 "(%llu -> %llu), skipping HPA handling\n",
1264 (unsigned long long)sectors,
1265 (unsigned long long)native_sectors);
1266 dev->horkage |= ATA_HORKAGE_BROKEN_HPA;
1271 /* re-read IDENTIFY data */
1272 rc = ata_dev_reread_id(dev, 0);
1274 ata_dev_printk(dev, KERN_ERR, "failed to re-read IDENTIFY "
1275 "data after HPA resizing\n");
1280 u64 new_sectors = ata_id_n_sectors(dev->id);
1281 ata_dev_printk(dev, KERN_INFO,
1282 "HPA unlocked: %llu -> %llu, native %llu\n",
1283 (unsigned long long)sectors,
1284 (unsigned long long)new_sectors,
1285 (unsigned long long)native_sectors);
1292 * ata_noop_dev_select - Select device 0/1 on ATA bus
1293 * @ap: ATA channel to manipulate
1294 * @device: ATA device (numbered from zero) to select
1296 * This function performs no actual function.
1298 * May be used as the dev_select() entry in ata_port_operations.
1303 void ata_noop_dev_select(struct ata_port *ap, unsigned int device)
1309 * ata_std_dev_select - Select device 0/1 on ATA bus
1310 * @ap: ATA channel to manipulate
1311 * @device: ATA device (numbered from zero) to select
1313 * Use the method defined in the ATA specification to
1314 * make either device 0, or device 1, active on the
1315 * ATA channel. Works with both PIO and MMIO.
1317 * May be used as the dev_select() entry in ata_port_operations.
1323 void ata_std_dev_select(struct ata_port *ap, unsigned int device)
1328 tmp = ATA_DEVICE_OBS;
1330 tmp = ATA_DEVICE_OBS | ATA_DEV1;
1332 iowrite8(tmp, ap->ioaddr.device_addr);
1333 ata_pause(ap); /* needed; also flushes, for mmio */
1337 * ata_dev_select - Select device 0/1 on ATA bus
1338 * @ap: ATA channel to manipulate
1339 * @device: ATA device (numbered from zero) to select
1340 * @wait: non-zero to wait for Status register BSY bit to clear
1341 * @can_sleep: non-zero if context allows sleeping
1343 * Use the method defined in the ATA specification to
1344 * make either device 0, or device 1, active on the
1347 * This is a high-level version of ata_std_dev_select(),
1348 * which additionally provides the services of inserting
1349 * the proper pauses and status polling, where needed.
1355 void ata_dev_select(struct ata_port *ap, unsigned int device,
1356 unsigned int wait, unsigned int can_sleep)
1358 if (ata_msg_probe(ap))
1359 ata_port_printk(ap, KERN_INFO, "ata_dev_select: ENTER, "
1360 "device %u, wait %u\n", device, wait);
1365 ap->ops->dev_select(ap, device);
1368 if (can_sleep && ap->link.device[device].class == ATA_DEV_ATAPI)
1375 * ata_dump_id - IDENTIFY DEVICE info debugging output
1376 * @id: IDENTIFY DEVICE page to dump
1378 * Dump selected 16-bit words from the given IDENTIFY DEVICE
1385 static inline void ata_dump_id(const u16 *id)
1387 DPRINTK("49==0x%04x "
1397 DPRINTK("80==0x%04x "
1407 DPRINTK("88==0x%04x "
1414 * ata_id_xfermask - Compute xfermask from the given IDENTIFY data
1415 * @id: IDENTIFY data to compute xfer mask from
1417 * Compute the xfermask for this device. This is not as trivial
1418 * as it seems if we must consider early devices correctly.
1420 * FIXME: pre IDE drive timing (do we care ?).
1428 unsigned long ata_id_xfermask(const u16 *id)
1430 unsigned long pio_mask, mwdma_mask, udma_mask;
1432 /* Usual case. Word 53 indicates word 64 is valid */
1433 if (id[ATA_ID_FIELD_VALID] & (1 << 1)) {
1434 pio_mask = id[ATA_ID_PIO_MODES] & 0x03;
1438 /* If word 64 isn't valid then Word 51 high byte holds
1439 * the PIO timing number for the maximum. Turn it into
1442 u8 mode = (id[ATA_ID_OLD_PIO_MODES] >> 8) & 0xFF;
1443 if (mode < 5) /* Valid PIO range */
1444 pio_mask = (2 << mode) - 1;
1448 /* But wait.. there's more. Design your standards by
1449 * committee and you too can get a free iordy field to
1450 * process. However its the speeds not the modes that
1451 * are supported... Note drivers using the timing API
1452 * will get this right anyway
1456 mwdma_mask = id[ATA_ID_MWDMA_MODES] & 0x07;
1458 if (ata_id_is_cfa(id)) {
1460 * Process compact flash extended modes
1462 int pio = id[163] & 0x7;
1463 int dma = (id[163] >> 3) & 7;
1466 pio_mask |= (1 << 5);
1468 pio_mask |= (1 << 6);
1470 mwdma_mask |= (1 << 3);
1472 mwdma_mask |= (1 << 4);
1476 if (id[ATA_ID_FIELD_VALID] & (1 << 2))
1477 udma_mask = id[ATA_ID_UDMA_MODES] & 0xff;
1479 return ata_pack_xfermask(pio_mask, mwdma_mask, udma_mask);
1483 * ata_port_queue_task - Queue port_task
1484 * @ap: The ata_port to queue port_task for
1485 * @fn: workqueue function to be scheduled
1486 * @data: data for @fn to use
1487 * @delay: delay time for workqueue function
1489 * Schedule @fn(@data) for execution after @delay jiffies using
1490 * port_task. There is one port_task per port and it's the
1491 * user(low level driver)'s responsibility to make sure that only
1492 * one task is active at any given time.
1494 * libata core layer takes care of synchronization between
1495 * port_task and EH. ata_port_queue_task() may be ignored for EH
1499 * Inherited from caller.
1501 void ata_port_queue_task(struct ata_port *ap, work_func_t fn, void *data,
1502 unsigned long delay)
1504 PREPARE_DELAYED_WORK(&ap->port_task, fn);
1505 ap->port_task_data = data;
1507 /* may fail if ata_port_flush_task() in progress */
1508 queue_delayed_work(ata_wq, &ap->port_task, delay);
1512 * ata_port_flush_task - Flush port_task
1513 * @ap: The ata_port to flush port_task for
1515 * After this function completes, port_task is guranteed not to
1516 * be running or scheduled.
1519 * Kernel thread context (may sleep)
1521 void ata_port_flush_task(struct ata_port *ap)
1525 cancel_rearming_delayed_work(&ap->port_task);
1527 if (ata_msg_ctl(ap))
1528 ata_port_printk(ap, KERN_DEBUG, "%s: EXIT\n", __FUNCTION__);
1531 static void ata_qc_complete_internal(struct ata_queued_cmd *qc)
1533 struct completion *waiting = qc->private_data;
1539 * ata_exec_internal_sg - execute libata internal command
1540 * @dev: Device to which the command is sent
1541 * @tf: Taskfile registers for the command and the result
1542 * @cdb: CDB for packet command
1543 * @dma_dir: Data tranfer direction of the command
1544 * @sgl: sg list for the data buffer of the command
1545 * @n_elem: Number of sg entries
1546 * @timeout: Timeout in msecs (0 for default)
1548 * Executes libata internal command with timeout. @tf contains
1549 * command on entry and result on return. Timeout and error
1550 * conditions are reported via return value. No recovery action
1551 * is taken after a command times out. It's caller's duty to
1552 * clean up after timeout.
1555 * None. Should be called with kernel context, might sleep.
1558 * Zero on success, AC_ERR_* mask on failure
1560 unsigned ata_exec_internal_sg(struct ata_device *dev,
1561 struct ata_taskfile *tf, const u8 *cdb,
1562 int dma_dir, struct scatterlist *sgl,
1563 unsigned int n_elem, unsigned long timeout)
1565 struct ata_link *link = dev->link;
1566 struct ata_port *ap = link->ap;
1567 u8 command = tf->command;
1568 struct ata_queued_cmd *qc;
1569 unsigned int tag, preempted_tag;
1570 u32 preempted_sactive, preempted_qc_active;
1571 int preempted_nr_active_links;
1572 DECLARE_COMPLETION_ONSTACK(wait);
1573 unsigned long flags;
1574 unsigned int err_mask;
1577 spin_lock_irqsave(ap->lock, flags);
1579 /* no internal command while frozen */
1580 if (ap->pflags & ATA_PFLAG_FROZEN) {
1581 spin_unlock_irqrestore(ap->lock, flags);
1582 return AC_ERR_SYSTEM;
1585 /* initialize internal qc */
1587 /* XXX: Tag 0 is used for drivers with legacy EH as some
1588 * drivers choke if any other tag is given. This breaks
1589 * ata_tag_internal() test for those drivers. Don't use new
1590 * EH stuff without converting to it.
1592 if (ap->ops->error_handler)
1593 tag = ATA_TAG_INTERNAL;
1597 if (test_and_set_bit(tag, &ap->qc_allocated))
1599 qc = __ata_qc_from_tag(ap, tag);
1607 preempted_tag = link->active_tag;
1608 preempted_sactive = link->sactive;
1609 preempted_qc_active = ap->qc_active;
1610 preempted_nr_active_links = ap->nr_active_links;
1611 link->active_tag = ATA_TAG_POISON;
1614 ap->nr_active_links = 0;
1616 /* prepare & issue qc */
1619 memcpy(qc->cdb, cdb, ATAPI_CDB_LEN);
1620 qc->flags |= ATA_QCFLAG_RESULT_TF;
1621 qc->dma_dir = dma_dir;
1622 if (dma_dir != DMA_NONE) {
1623 unsigned int i, buflen = 0;
1624 struct scatterlist *sg;
1626 for_each_sg(sgl, sg, n_elem, i)
1627 buflen += sg->length;
1629 ata_sg_init(qc, sgl, n_elem);
1630 qc->nbytes = buflen;
1633 qc->private_data = &wait;
1634 qc->complete_fn = ata_qc_complete_internal;
1638 spin_unlock_irqrestore(ap->lock, flags);
1641 timeout = ata_probe_timeout * 1000 / HZ;
1643 rc = wait_for_completion_timeout(&wait, msecs_to_jiffies(timeout));
1645 ata_port_flush_task(ap);
1648 spin_lock_irqsave(ap->lock, flags);
1650 /* We're racing with irq here. If we lose, the
1651 * following test prevents us from completing the qc
1652 * twice. If we win, the port is frozen and will be
1653 * cleaned up by ->post_internal_cmd().
1655 if (qc->flags & ATA_QCFLAG_ACTIVE) {
1656 qc->err_mask |= AC_ERR_TIMEOUT;
1658 if (ap->ops->error_handler)
1659 ata_port_freeze(ap);
1661 ata_qc_complete(qc);
1663 if (ata_msg_warn(ap))
1664 ata_dev_printk(dev, KERN_WARNING,
1665 "qc timeout (cmd 0x%x)\n", command);
1668 spin_unlock_irqrestore(ap->lock, flags);
1671 /* do post_internal_cmd */
1672 if (ap->ops->post_internal_cmd)
1673 ap->ops->post_internal_cmd(qc);
1675 /* perform minimal error analysis */
1676 if (qc->flags & ATA_QCFLAG_FAILED) {
1677 if (qc->result_tf.command & (ATA_ERR | ATA_DF))
1678 qc->err_mask |= AC_ERR_DEV;
1681 qc->err_mask |= AC_ERR_OTHER;
1683 if (qc->err_mask & ~AC_ERR_OTHER)
1684 qc->err_mask &= ~AC_ERR_OTHER;
1688 spin_lock_irqsave(ap->lock, flags);
1690 *tf = qc->result_tf;
1691 err_mask = qc->err_mask;
1694 link->active_tag = preempted_tag;
1695 link->sactive = preempted_sactive;
1696 ap->qc_active = preempted_qc_active;
1697 ap->nr_active_links = preempted_nr_active_links;
1699 /* XXX - Some LLDDs (sata_mv) disable port on command failure.
1700 * Until those drivers are fixed, we detect the condition
1701 * here, fail the command with AC_ERR_SYSTEM and reenable the
1704 * Note that this doesn't change any behavior as internal
1705 * command failure results in disabling the device in the
1706 * higher layer for LLDDs without new reset/EH callbacks.
1708 * Kill the following code as soon as those drivers are fixed.
1710 if (ap->flags & ATA_FLAG_DISABLED) {
1711 err_mask |= AC_ERR_SYSTEM;
1715 spin_unlock_irqrestore(ap->lock, flags);
1721 * ata_exec_internal - execute libata internal command
1722 * @dev: Device to which the command is sent
1723 * @tf: Taskfile registers for the command and the result
1724 * @cdb: CDB for packet command
1725 * @dma_dir: Data tranfer direction of the command
1726 * @buf: Data buffer of the command
1727 * @buflen: Length of data buffer
1728 * @timeout: Timeout in msecs (0 for default)
1730 * Wrapper around ata_exec_internal_sg() which takes simple
1731 * buffer instead of sg list.
1734 * None. Should be called with kernel context, might sleep.
1737 * Zero on success, AC_ERR_* mask on failure
1739 unsigned ata_exec_internal(struct ata_device *dev,
1740 struct ata_taskfile *tf, const u8 *cdb,
1741 int dma_dir, void *buf, unsigned int buflen,
1742 unsigned long timeout)
1744 struct scatterlist *psg = NULL, sg;
1745 unsigned int n_elem = 0;
1747 if (dma_dir != DMA_NONE) {
1749 sg_init_one(&sg, buf, buflen);
1754 return ata_exec_internal_sg(dev, tf, cdb, dma_dir, psg, n_elem,
1759 * ata_do_simple_cmd - execute simple internal command
1760 * @dev: Device to which the command is sent
1761 * @cmd: Opcode to execute
1763 * Execute a 'simple' command, that only consists of the opcode
1764 * 'cmd' itself, without filling any other registers
1767 * Kernel thread context (may sleep).
1770 * Zero on success, AC_ERR_* mask on failure
1772 unsigned int ata_do_simple_cmd(struct ata_device *dev, u8 cmd)
1774 struct ata_taskfile tf;
1776 ata_tf_init(dev, &tf);
1779 tf.flags |= ATA_TFLAG_DEVICE;
1780 tf.protocol = ATA_PROT_NODATA;
1782 return ata_exec_internal(dev, &tf, NULL, DMA_NONE, NULL, 0, 0);
1786 * ata_pio_need_iordy - check if iordy needed
1789 * Check if the current speed of the device requires IORDY. Used
1790 * by various controllers for chip configuration.
1793 unsigned int ata_pio_need_iordy(const struct ata_device *adev)
1795 /* Controller doesn't support IORDY. Probably a pointless check
1796 as the caller should know this */
1797 if (adev->link->ap->flags & ATA_FLAG_NO_IORDY)
1799 /* PIO3 and higher it is mandatory */
1800 if (adev->pio_mode > XFER_PIO_2)
1802 /* We turn it on when possible */
1803 if (ata_id_has_iordy(adev->id))
1809 * ata_pio_mask_no_iordy - Return the non IORDY mask
1812 * Compute the highest mode possible if we are not using iordy. Return
1813 * -1 if no iordy mode is available.
1816 static u32 ata_pio_mask_no_iordy(const struct ata_device *adev)
1818 /* If we have no drive specific rule, then PIO 2 is non IORDY */
1819 if (adev->id[ATA_ID_FIELD_VALID] & 2) { /* EIDE */
1820 u16 pio = adev->id[ATA_ID_EIDE_PIO];
1821 /* Is the speed faster than the drive allows non IORDY ? */
1823 /* This is cycle times not frequency - watch the logic! */
1824 if (pio > 240) /* PIO2 is 240nS per cycle */
1825 return 3 << ATA_SHIFT_PIO;
1826 return 7 << ATA_SHIFT_PIO;
1829 return 3 << ATA_SHIFT_PIO;
1833 * ata_dev_read_id - Read ID data from the specified device
1834 * @dev: target device
1835 * @p_class: pointer to class of the target device (may be changed)
1836 * @flags: ATA_READID_* flags
1837 * @id: buffer to read IDENTIFY data into
1839 * Read ID data from the specified device. ATA_CMD_ID_ATA is
1840 * performed on ATA devices and ATA_CMD_ID_ATAPI on ATAPI
1841 * devices. This function also issues ATA_CMD_INIT_DEV_PARAMS
1842 * for pre-ATA4 drives.
1844 * FIXME: ATA_CMD_ID_ATA is optional for early drives and right
1845 * now we abort if we hit that case.
1848 * Kernel thread context (may sleep)
1851 * 0 on success, -errno otherwise.
1853 int ata_dev_read_id(struct ata_device *dev, unsigned int *p_class,
1854 unsigned int flags, u16 *id)
1856 struct ata_port *ap = dev->link->ap;
1857 unsigned int class = *p_class;
1858 struct ata_taskfile tf;
1859 unsigned int err_mask = 0;
1861 int may_fallback = 1, tried_spinup = 0;
1864 if (ata_msg_ctl(ap))
1865 ata_dev_printk(dev, KERN_DEBUG, "%s: ENTER\n", __FUNCTION__);
1867 ata_dev_select(ap, dev->devno, 1, 1); /* select device 0/1 */
1869 ata_tf_init(dev, &tf);
1873 tf.command = ATA_CMD_ID_ATA;
1876 tf.command = ATA_CMD_ID_ATAPI;
1880 reason = "unsupported class";
1884 tf.protocol = ATA_PROT_PIO;
1886 /* Some devices choke if TF registers contain garbage. Make
1887 * sure those are properly initialized.
1889 tf.flags |= ATA_TFLAG_ISADDR | ATA_TFLAG_DEVICE;
1891 /* Device presence detection is unreliable on some
1892 * controllers. Always poll IDENTIFY if available.
1894 tf.flags |= ATA_TFLAG_POLLING;
1896 err_mask = ata_exec_internal(dev, &tf, NULL, DMA_FROM_DEVICE,
1897 id, sizeof(id[0]) * ATA_ID_WORDS, 0);
1899 if (err_mask & AC_ERR_NODEV_HINT) {
1900 DPRINTK("ata%u.%d: NODEV after polling detection\n",
1901 ap->print_id, dev->devno);
1905 /* Device or controller might have reported the wrong
1906 * device class. Give a shot at the other IDENTIFY if
1907 * the current one is aborted by the device.
1910 (err_mask == AC_ERR_DEV) && (tf.feature & ATA_ABORTED)) {
1913 if (class == ATA_DEV_ATA)
1914 class = ATA_DEV_ATAPI;
1916 class = ATA_DEV_ATA;
1921 reason = "I/O error";
1925 /* Falling back doesn't make sense if ID data was read
1926 * successfully at least once.
1930 swap_buf_le16(id, ATA_ID_WORDS);
1934 reason = "device reports invalid type";
1936 if (class == ATA_DEV_ATA) {
1937 if (!ata_id_is_ata(id) && !ata_id_is_cfa(id))
1940 if (ata_id_is_ata(id))
1944 if (!tried_spinup && (id[2] == 0x37c8 || id[2] == 0x738c)) {
1947 * Drive powered-up in standby mode, and requires a specific
1948 * SET_FEATURES spin-up subcommand before it will accept
1949 * anything other than the original IDENTIFY command.
1951 err_mask = ata_dev_set_feature(dev, SETFEATURES_SPINUP, 0);
1952 if (err_mask && id[2] != 0x738c) {
1954 reason = "SPINUP failed";
1958 * If the drive initially returned incomplete IDENTIFY info,
1959 * we now must reissue the IDENTIFY command.
1961 if (id[2] == 0x37c8)
1965 if ((flags & ATA_READID_POSTRESET) && class == ATA_DEV_ATA) {
1967 * The exact sequence expected by certain pre-ATA4 drives is:
1969 * IDENTIFY (optional in early ATA)
1970 * INITIALIZE DEVICE PARAMETERS (later IDE and ATA)
1972 * Some drives were very specific about that exact sequence.
1974 * Note that ATA4 says lba is mandatory so the second check
1975 * shoud never trigger.
1977 if (ata_id_major_version(id) < 4 || !ata_id_has_lba(id)) {
1978 err_mask = ata_dev_init_params(dev, id[3], id[6]);
1981 reason = "INIT_DEV_PARAMS failed";
1985 /* current CHS translation info (id[53-58]) might be
1986 * changed. reread the identify device info.
1988 flags &= ~ATA_READID_POSTRESET;
1998 if (ata_msg_warn(ap))
1999 ata_dev_printk(dev, KERN_WARNING, "failed to IDENTIFY "
2000 "(%s, err_mask=0x%x)\n", reason, err_mask);
2004 static inline u8 ata_dev_knobble(struct ata_device *dev)
2006 struct ata_port *ap = dev->link->ap;
2007 return ((ap->cbl == ATA_CBL_SATA) && (!ata_id_is_sata(dev->id)));
2010 static void ata_dev_config_ncq(struct ata_device *dev,
2011 char *desc, size_t desc_sz)
2013 struct ata_port *ap = dev->link->ap;
2014 int hdepth = 0, ddepth = ata_id_queue_depth(dev->id);
2016 if (!ata_id_has_ncq(dev->id)) {
2020 if (dev->horkage & ATA_HORKAGE_NONCQ) {
2021 snprintf(desc, desc_sz, "NCQ (not used)");
2024 if (ap->flags & ATA_FLAG_NCQ) {
2025 hdepth = min(ap->scsi_host->can_queue, ATA_MAX_QUEUE - 1);
2026 dev->flags |= ATA_DFLAG_NCQ;
2029 if (hdepth >= ddepth)
2030 snprintf(desc, desc_sz, "NCQ (depth %d)", ddepth);
2032 snprintf(desc, desc_sz, "NCQ (depth %d/%d)", hdepth, ddepth);
2036 * ata_dev_configure - Configure the specified ATA/ATAPI device
2037 * @dev: Target device to configure
2039 * Configure @dev according to @dev->id. Generic and low-level
2040 * driver specific fixups are also applied.
2043 * Kernel thread context (may sleep)
2046 * 0 on success, -errno otherwise
2048 int ata_dev_configure(struct ata_device *dev)
2050 struct ata_port *ap = dev->link->ap;
2051 struct ata_eh_context *ehc = &dev->link->eh_context;
2052 int print_info = ehc->i.flags & ATA_EHI_PRINTINFO;
2053 const u16 *id = dev->id;
2054 unsigned long xfer_mask;
2055 char revbuf[7]; /* XYZ-99\0 */
2056 char fwrevbuf[ATA_ID_FW_REV_LEN+1];
2057 char modelbuf[ATA_ID_PROD_LEN+1];
2060 if (!ata_dev_enabled(dev) && ata_msg_info(ap)) {
2061 ata_dev_printk(dev, KERN_INFO, "%s: ENTER/EXIT -- nodev\n",
2066 if (ata_msg_probe(ap))
2067 ata_dev_printk(dev, KERN_DEBUG, "%s: ENTER\n", __FUNCTION__);
2070 dev->horkage |= ata_dev_blacklisted(dev);
2072 /* let ACPI work its magic */
2073 rc = ata_acpi_on_devcfg(dev);
2077 /* massage HPA, do it early as it might change IDENTIFY data */
2078 rc = ata_hpa_resize(dev);
2082 /* print device capabilities */
2083 if (ata_msg_probe(ap))
2084 ata_dev_printk(dev, KERN_DEBUG,
2085 "%s: cfg 49:%04x 82:%04x 83:%04x 84:%04x "
2086 "85:%04x 86:%04x 87:%04x 88:%04x\n",
2088 id[49], id[82], id[83], id[84],
2089 id[85], id[86], id[87], id[88]);
2091 /* initialize to-be-configured parameters */
2092 dev->flags &= ~ATA_DFLAG_CFG_MASK;
2093 dev->max_sectors = 0;
2101 * common ATA, ATAPI feature tests
2104 /* find max transfer mode; for printk only */
2105 xfer_mask = ata_id_xfermask(id);
2107 if (ata_msg_probe(ap))
2110 /* SCSI only uses 4-char revisions, dump full 8 chars from ATA */
2111 ata_id_c_string(dev->id, fwrevbuf, ATA_ID_FW_REV,
2114 ata_id_c_string(dev->id, modelbuf, ATA_ID_PROD,
2117 /* ATA-specific feature tests */
2118 if (dev->class == ATA_DEV_ATA) {
2119 if (ata_id_is_cfa(id)) {
2120 if (id[162] & 1) /* CPRM may make this media unusable */
2121 ata_dev_printk(dev, KERN_WARNING,
2122 "supports DRM functions and may "
2123 "not be fully accessable.\n");
2124 snprintf(revbuf, 7, "CFA");
2126 snprintf(revbuf, 7, "ATA-%d", ata_id_major_version(id));
2127 /* Warn the user if the device has TPM extensions */
2128 if (ata_id_has_tpm(id))
2129 ata_dev_printk(dev, KERN_WARNING,
2130 "supports DRM functions and may "
2131 "not be fully accessable.\n");
2134 dev->n_sectors = ata_id_n_sectors(id);
2136 if (dev->id[59] & 0x100)
2137 dev->multi_count = dev->id[59] & 0xff;
2139 if (ata_id_has_lba(id)) {
2140 const char *lba_desc;
2144 dev->flags |= ATA_DFLAG_LBA;
2145 if (ata_id_has_lba48(id)) {
2146 dev->flags |= ATA_DFLAG_LBA48;
2149 if (dev->n_sectors >= (1UL << 28) &&
2150 ata_id_has_flush_ext(id))
2151 dev->flags |= ATA_DFLAG_FLUSH_EXT;
2155 ata_dev_config_ncq(dev, ncq_desc, sizeof(ncq_desc));
2157 /* print device info to dmesg */
2158 if (ata_msg_drv(ap) && print_info) {
2159 ata_dev_printk(dev, KERN_INFO,
2160 "%s: %s, %s, max %s\n",
2161 revbuf, modelbuf, fwrevbuf,
2162 ata_mode_string(xfer_mask));
2163 ata_dev_printk(dev, KERN_INFO,
2164 "%Lu sectors, multi %u: %s %s\n",
2165 (unsigned long long)dev->n_sectors,
2166 dev->multi_count, lba_desc, ncq_desc);
2171 /* Default translation */
2172 dev->cylinders = id[1];
2174 dev->sectors = id[6];
2176 if (ata_id_current_chs_valid(id)) {
2177 /* Current CHS translation is valid. */
2178 dev->cylinders = id[54];
2179 dev->heads = id[55];
2180 dev->sectors = id[56];
2183 /* print device info to dmesg */
2184 if (ata_msg_drv(ap) && print_info) {
2185 ata_dev_printk(dev, KERN_INFO,
2186 "%s: %s, %s, max %s\n",
2187 revbuf, modelbuf, fwrevbuf,
2188 ata_mode_string(xfer_mask));
2189 ata_dev_printk(dev, KERN_INFO,
2190 "%Lu sectors, multi %u, CHS %u/%u/%u\n",
2191 (unsigned long long)dev->n_sectors,
2192 dev->multi_count, dev->cylinders,
2193 dev->heads, dev->sectors);
2200 /* ATAPI-specific feature tests */
2201 else if (dev->class == ATA_DEV_ATAPI) {
2202 const char *cdb_intr_string = "";
2203 const char *atapi_an_string = "";
2206 rc = atapi_cdb_len(id);
2207 if ((rc < 12) || (rc > ATAPI_CDB_LEN)) {
2208 if (ata_msg_warn(ap))
2209 ata_dev_printk(dev, KERN_WARNING,
2210 "unsupported CDB len\n");
2214 dev->cdb_len = (unsigned int) rc;
2216 /* Enable ATAPI AN if both the host and device have
2217 * the support. If PMP is attached, SNTF is required
2218 * to enable ATAPI AN to discern between PHY status
2219 * changed notifications and ATAPI ANs.
2221 if ((ap->flags & ATA_FLAG_AN) && ata_id_has_atapi_AN(id) &&
2222 (!ap->nr_pmp_links ||
2223 sata_scr_read(&ap->link, SCR_NOTIFICATION, &sntf) == 0)) {
2224 unsigned int err_mask;
2226 /* issue SET feature command to turn this on */
2227 err_mask = ata_dev_set_feature(dev,
2228 SETFEATURES_SATA_ENABLE, SATA_AN);
2230 ata_dev_printk(dev, KERN_ERR,
2231 "failed to enable ATAPI AN "
2232 "(err_mask=0x%x)\n", err_mask);
2234 dev->flags |= ATA_DFLAG_AN;
2235 atapi_an_string = ", ATAPI AN";
2239 if (ata_id_cdb_intr(dev->id)) {
2240 dev->flags |= ATA_DFLAG_CDB_INTR;
2241 cdb_intr_string = ", CDB intr";
2244 /* print device info to dmesg */
2245 if (ata_msg_drv(ap) && print_info)
2246 ata_dev_printk(dev, KERN_INFO,
2247 "ATAPI: %s, %s, max %s%s%s\n",
2249 ata_mode_string(xfer_mask),
2250 cdb_intr_string, atapi_an_string);
2253 /* determine max_sectors */
2254 dev->max_sectors = ATA_MAX_SECTORS;
2255 if (dev->flags & ATA_DFLAG_LBA48)
2256 dev->max_sectors = ATA_MAX_SECTORS_LBA48;
2258 if (!(dev->horkage & ATA_HORKAGE_IPM)) {
2259 if (ata_id_has_hipm(dev->id))
2260 dev->flags |= ATA_DFLAG_HIPM;
2261 if (ata_id_has_dipm(dev->id))
2262 dev->flags |= ATA_DFLAG_DIPM;
2265 if (dev->horkage & ATA_HORKAGE_DIAGNOSTIC) {
2266 /* Let the user know. We don't want to disallow opens for
2267 rescue purposes, or in case the vendor is just a blithering
2270 ata_dev_printk(dev, KERN_WARNING,
2271 "Drive reports diagnostics failure. This may indicate a drive\n");
2272 ata_dev_printk(dev, KERN_WARNING,
2273 "fault or invalid emulation. Contact drive vendor for information.\n");
2277 /* limit bridge transfers to udma5, 200 sectors */
2278 if (ata_dev_knobble(dev)) {
2279 if (ata_msg_drv(ap) && print_info)
2280 ata_dev_printk(dev, KERN_INFO,
2281 "applying bridge limits\n");
2282 dev->udma_mask &= ATA_UDMA5;
2283 dev->max_sectors = ATA_MAX_SECTORS;
2286 if ((dev->class == ATA_DEV_ATAPI) &&
2287 (atapi_command_packet_set(id) == TYPE_TAPE)) {
2288 dev->max_sectors = ATA_MAX_SECTORS_TAPE;
2289 dev->horkage |= ATA_HORKAGE_STUCK_ERR;
2292 if (dev->horkage & ATA_HORKAGE_MAX_SEC_128)
2293 dev->max_sectors = min_t(unsigned int, ATA_MAX_SECTORS_128,
2296 if (ata_dev_blacklisted(dev) & ATA_HORKAGE_IPM) {
2297 dev->horkage |= ATA_HORKAGE_IPM;
2299 /* reset link pm_policy for this port to no pm */
2300 ap->pm_policy = MAX_PERFORMANCE;
2303 if (ap->ops->dev_config)
2304 ap->ops->dev_config(dev);
2306 if (ata_msg_probe(ap))
2307 ata_dev_printk(dev, KERN_DEBUG, "%s: EXIT, drv_stat = 0x%x\n",
2308 __FUNCTION__, ata_chk_status(ap));
2312 if (ata_msg_probe(ap))
2313 ata_dev_printk(dev, KERN_DEBUG,
2314 "%s: EXIT, err\n", __FUNCTION__);
2319 * ata_cable_40wire - return 40 wire cable type
2322 * Helper method for drivers which want to hardwire 40 wire cable
2326 int ata_cable_40wire(struct ata_port *ap)
2328 return ATA_CBL_PATA40;
2332 * ata_cable_80wire - return 80 wire cable type
2335 * Helper method for drivers which want to hardwire 80 wire cable
2339 int ata_cable_80wire(struct ata_port *ap)
2341 return ATA_CBL_PATA80;
2345 * ata_cable_unknown - return unknown PATA cable.
2348 * Helper method for drivers which have no PATA cable detection.
2351 int ata_cable_unknown(struct ata_port *ap)
2353 return ATA_CBL_PATA_UNK;
2357 * ata_cable_ignore - return ignored PATA cable.
2360 * Helper method for drivers which don't use cable type to limit
2363 int ata_cable_ignore(struct ata_port *ap)
2365 return ATA_CBL_PATA_IGN;
2369 * ata_cable_sata - return SATA cable type
2372 * Helper method for drivers which have SATA cables
2375 int ata_cable_sata(struct ata_port *ap)
2377 return ATA_CBL_SATA;
2381 * ata_bus_probe - Reset and probe ATA bus
2384 * Master ATA bus probing function. Initiates a hardware-dependent
2385 * bus reset, then attempts to identify any devices found on
2389 * PCI/etc. bus probe sem.
2392 * Zero on success, negative errno otherwise.
2395 int ata_bus_probe(struct ata_port *ap)
2397 unsigned int classes[ATA_MAX_DEVICES];
2398 int tries[ATA_MAX_DEVICES];
2400 struct ata_device *dev;
2404 ata_link_for_each_dev(dev, &ap->link)
2405 tries[dev->devno] = ATA_PROBE_MAX_TRIES;
2408 ata_link_for_each_dev(dev, &ap->link) {
2409 /* If we issue an SRST then an ATA drive (not ATAPI)
2410 * may change configuration and be in PIO0 timing. If
2411 * we do a hard reset (or are coming from power on)
2412 * this is true for ATA or ATAPI. Until we've set a
2413 * suitable controller mode we should not touch the
2414 * bus as we may be talking too fast.
2416 dev->pio_mode = XFER_PIO_0;
2418 /* If the controller has a pio mode setup function
2419 * then use it to set the chipset to rights. Don't
2420 * touch the DMA setup as that will be dealt with when
2421 * configuring devices.
2423 if (ap->ops->set_piomode)
2424 ap->ops->set_piomode(ap, dev);
2427 /* reset and determine device classes */
2428 ap->ops->phy_reset(ap);
2430 ata_link_for_each_dev(dev, &ap->link) {
2431 if (!(ap->flags & ATA_FLAG_DISABLED) &&
2432 dev->class != ATA_DEV_UNKNOWN)
2433 classes[dev->devno] = dev->class;
2435 classes[dev->devno] = ATA_DEV_NONE;
2437 dev->class = ATA_DEV_UNKNOWN;
2442 /* read IDENTIFY page and configure devices. We have to do the identify
2443 specific sequence bass-ackwards so that PDIAG- is released by
2446 ata_link_for_each_dev(dev, &ap->link) {
2447 if (tries[dev->devno])
2448 dev->class = classes[dev->devno];
2450 if (!ata_dev_enabled(dev))
2453 rc = ata_dev_read_id(dev, &dev->class, ATA_READID_POSTRESET,
2459 /* Now ask for the cable type as PDIAG- should have been released */
2460 if (ap->ops->cable_detect)
2461 ap->cbl = ap->ops->cable_detect(ap);
2463 /* We may have SATA bridge glue hiding here irrespective of the
2464 reported cable types and sensed types */
2465 ata_link_for_each_dev(dev, &ap->link) {
2466 if (!ata_dev_enabled(dev))
2468 /* SATA drives indicate we have a bridge. We don't know which
2469 end of the link the bridge is which is a problem */
2470 if (ata_id_is_sata(dev->id))
2471 ap->cbl = ATA_CBL_SATA;
2474 /* After the identify sequence we can now set up the devices. We do
2475 this in the normal order so that the user doesn't get confused */
2477 ata_link_for_each_dev(dev, &ap->link) {
2478 if (!ata_dev_enabled(dev))
2481 ap->link.eh_context.i.flags |= ATA_EHI_PRINTINFO;
2482 rc = ata_dev_configure(dev);
2483 ap->link.eh_context.i.flags &= ~ATA_EHI_PRINTINFO;
2488 /* configure transfer mode */
2489 rc = ata_set_mode(&ap->link, &dev);
2493 ata_link_for_each_dev(dev, &ap->link)
2494 if (ata_dev_enabled(dev))
2497 /* no device present, disable port */
2498 ata_port_disable(ap);
2502 tries[dev->devno]--;
2506 /* eeek, something went very wrong, give up */
2507 tries[dev->devno] = 0;
2511 /* give it just one more chance */
2512 tries[dev->devno] = min(tries[dev->devno], 1);
2514 if (tries[dev->devno] == 1) {
2515 /* This is the last chance, better to slow
2516 * down than lose it.
2518 sata_down_spd_limit(&ap->link);
2519 ata_down_xfermask_limit(dev, ATA_DNXFER_PIO);
2523 if (!tries[dev->devno])
2524 ata_dev_disable(dev);
2530 * ata_port_probe - Mark port as enabled
2531 * @ap: Port for which we indicate enablement
2533 * Modify @ap data structure such that the system
2534 * thinks that the entire port is enabled.
2536 * LOCKING: host lock, or some other form of
2540 void ata_port_probe(struct ata_port *ap)
2542 ap->flags &= ~ATA_FLAG_DISABLED;
2546 * sata_print_link_status - Print SATA link status
2547 * @link: SATA link to printk link status about
2549 * This function prints link speed and status of a SATA link.
2554 void sata_print_link_status(struct ata_link *link)
2556 u32 sstatus, scontrol, tmp;
2558 if (sata_scr_read(link, SCR_STATUS, &sstatus))
2560 sata_scr_read(link, SCR_CONTROL, &scontrol);
2562 if (ata_link_online(link)) {
2563 tmp = (sstatus >> 4) & 0xf;
2564 ata_link_printk(link, KERN_INFO,
2565 "SATA link up %s (SStatus %X SControl %X)\n",
2566 sata_spd_string(tmp), sstatus, scontrol);
2568 ata_link_printk(link, KERN_INFO,
2569 "SATA link down (SStatus %X SControl %X)\n",
2575 * ata_dev_pair - return other device on cable
2578 * Obtain the other device on the same cable, or if none is
2579 * present NULL is returned
2582 struct ata_device *ata_dev_pair(struct ata_device *adev)
2584 struct ata_link *link = adev->link;
2585 struct ata_device *pair = &link->device[1 - adev->devno];
2586 if (!ata_dev_enabled(pair))
2592 * ata_port_disable - Disable port.
2593 * @ap: Port to be disabled.
2595 * Modify @ap data structure such that the system
2596 * thinks that the entire port is disabled, and should
2597 * never attempt to probe or communicate with devices
2600 * LOCKING: host lock, or some other form of
2604 void ata_port_disable(struct ata_port *ap)
2606 ap->link.device[0].class = ATA_DEV_NONE;
2607 ap->link.device[1].class = ATA_DEV_NONE;
2608 ap->flags |= ATA_FLAG_DISABLED;
2612 * sata_down_spd_limit - adjust SATA spd limit downward
2613 * @link: Link to adjust SATA spd limit for
2615 * Adjust SATA spd limit of @link downward. Note that this
2616 * function only adjusts the limit. The change must be applied
2617 * using sata_set_spd().
2620 * Inherited from caller.
2623 * 0 on success, negative errno on failure
2625 int sata_down_spd_limit(struct ata_link *link)
2627 u32 sstatus, spd, mask;
2630 if (!sata_scr_valid(link))
2633 /* If SCR can be read, use it to determine the current SPD.
2634 * If not, use cached value in link->sata_spd.
2636 rc = sata_scr_read(link, SCR_STATUS, &sstatus);
2638 spd = (sstatus >> 4) & 0xf;
2640 spd = link->sata_spd;
2642 mask = link->sata_spd_limit;
2646 /* unconditionally mask off the highest bit */
2647 highbit = fls(mask) - 1;
2648 mask &= ~(1 << highbit);
2650 /* Mask off all speeds higher than or equal to the current
2651 * one. Force 1.5Gbps if current SPD is not available.
2654 mask &= (1 << (spd - 1)) - 1;
2658 /* were we already at the bottom? */
2662 link->sata_spd_limit = mask;
2664 ata_link_printk(link, KERN_WARNING, "limiting SATA link speed to %s\n",
2665 sata_spd_string(fls(mask)));
2670 static int __sata_set_spd_needed(struct ata_link *link, u32 *scontrol)
2672 struct ata_link *host_link = &link->ap->link;
2673 u32 limit, target, spd;
2675 limit = link->sata_spd_limit;
2677 /* Don't configure downstream link faster than upstream link.
2678 * It doesn't speed up anything and some PMPs choke on such
2681 if (!ata_is_host_link(link) && host_link->sata_spd)
2682 limit &= (1 << host_link->sata_spd) - 1;
2684 if (limit == UINT_MAX)
2687 target = fls(limit);
2689 spd = (*scontrol >> 4) & 0xf;
2690 *scontrol = (*scontrol & ~0xf0) | ((target & 0xf) << 4);
2692 return spd != target;
2696 * sata_set_spd_needed - is SATA spd configuration needed
2697 * @link: Link in question
2699 * Test whether the spd limit in SControl matches
2700 * @link->sata_spd_limit. This function is used to determine
2701 * whether hardreset is necessary to apply SATA spd
2705 * Inherited from caller.
2708 * 1 if SATA spd configuration is needed, 0 otherwise.
2710 int sata_set_spd_needed(struct ata_link *link)
2714 if (sata_scr_read(link, SCR_CONTROL, &scontrol))
2717 return __sata_set_spd_needed(link, &scontrol);
2721 * sata_set_spd - set SATA spd according to spd limit
2722 * @link: Link to set SATA spd for
2724 * Set SATA spd of @link according to sata_spd_limit.
2727 * Inherited from caller.
2730 * 0 if spd doesn't need to be changed, 1 if spd has been
2731 * changed. Negative errno if SCR registers are inaccessible.
2733 int sata_set_spd(struct ata_link *link)
2738 if ((rc = sata_scr_read(link, SCR_CONTROL, &scontrol)))
2741 if (!__sata_set_spd_needed(link, &scontrol))
2744 if ((rc = sata_scr_write(link, SCR_CONTROL, scontrol)))
2751 * This mode timing computation functionality is ported over from
2752 * drivers/ide/ide-timing.h and was originally written by Vojtech Pavlik
2755 * PIO 0-4, MWDMA 0-2 and UDMA 0-6 timings (in nanoseconds).
2756 * These were taken from ATA/ATAPI-6 standard, rev 0a, except
2757 * for UDMA6, which is currently supported only by Maxtor drives.
2759 * For PIO 5/6 MWDMA 3/4 see the CFA specification 3.0.
2762 static const struct ata_timing ata_timing[] = {
2763 /* { XFER_PIO_SLOW, 120, 290, 240, 960, 290, 240, 960, 0 }, */
2764 { XFER_PIO_0, 70, 290, 240, 600, 165, 150, 600, 0 },
2765 { XFER_PIO_1, 50, 290, 93, 383, 125, 100, 383, 0 },
2766 { XFER_PIO_2, 30, 290, 40, 330, 100, 90, 240, 0 },
2767 { XFER_PIO_3, 30, 80, 70, 180, 80, 70, 180, 0 },
2768 { XFER_PIO_4, 25, 70, 25, 120, 70, 25, 120, 0 },
2769 { XFER_PIO_5, 15, 65, 25, 100, 65, 25, 100, 0 },
2770 { XFER_PIO_6, 10, 55, 20, 80, 55, 20, 80, 0 },
2772 { XFER_SW_DMA_0, 120, 0, 0, 0, 480, 480, 960, 0 },
2773 { XFER_SW_DMA_1, 90, 0, 0, 0, 240, 240, 480, 0 },
2774 { XFER_SW_DMA_2, 60, 0, 0, 0, 120, 120, 240, 0 },
2776 { XFER_MW_DMA_0, 60, 0, 0, 0, 215, 215, 480, 0 },
2777 { XFER_MW_DMA_1, 45, 0, 0, 0, 80, 50, 150, 0 },
2778 { XFER_MW_DMA_2, 25, 0, 0, 0, 70, 25, 120, 0 },
2779 { XFER_MW_DMA_3, 25, 0, 0, 0, 65, 25, 100, 0 },
2780 { XFER_MW_DMA_4, 25, 0, 0, 0, 55, 20, 80, 0 },
2782 /* { XFER_UDMA_SLOW, 0, 0, 0, 0, 0, 0, 0, 150 }, */
2783 { XFER_UDMA_0, 0, 0, 0, 0, 0, 0, 0, 120 },
2784 { XFER_UDMA_1, 0, 0, 0, 0, 0, 0, 0, 80 },
2785 { XFER_UDMA_2, 0, 0, 0, 0, 0, 0, 0, 60 },
2786 { XFER_UDMA_3, 0, 0, 0, 0, 0, 0, 0, 45 },
2787 { XFER_UDMA_4, 0, 0, 0, 0, 0, 0, 0, 30 },
2788 { XFER_UDMA_5, 0, 0, 0, 0, 0, 0, 0, 20 },
2789 { XFER_UDMA_6, 0, 0, 0, 0, 0, 0, 0, 15 },
2794 #define ENOUGH(v, unit) (((v)-1)/(unit)+1)
2795 #define EZ(v, unit) ((v)?ENOUGH(v, unit):0)
2797 static void ata_timing_quantize(const struct ata_timing *t, struct ata_timing *q, int T, int UT)
2799 q->setup = EZ(t->setup * 1000, T);
2800 q->act8b = EZ(t->act8b * 1000, T);
2801 q->rec8b = EZ(t->rec8b * 1000, T);
2802 q->cyc8b = EZ(t->cyc8b * 1000, T);
2803 q->active = EZ(t->active * 1000, T);
2804 q->recover = EZ(t->recover * 1000, T);
2805 q->cycle = EZ(t->cycle * 1000, T);
2806 q->udma = EZ(t->udma * 1000, UT);
2809 void ata_timing_merge(const struct ata_timing *a, const struct ata_timing *b,
2810 struct ata_timing *m, unsigned int what)
2812 if (what & ATA_TIMING_SETUP ) m->setup = max(a->setup, b->setup);
2813 if (what & ATA_TIMING_ACT8B ) m->act8b = max(a->act8b, b->act8b);
2814 if (what & ATA_TIMING_REC8B ) m->rec8b = max(a->rec8b, b->rec8b);
2815 if (what & ATA_TIMING_CYC8B ) m->cyc8b = max(a->cyc8b, b->cyc8b);
2816 if (what & ATA_TIMING_ACTIVE ) m->active = max(a->active, b->active);
2817 if (what & ATA_TIMING_RECOVER) m->recover = max(a->recover, b->recover);
2818 if (what & ATA_TIMING_CYCLE ) m->cycle = max(a->cycle, b->cycle);
2819 if (what & ATA_TIMING_UDMA ) m->udma = max(a->udma, b->udma);
2822 const struct ata_timing *ata_timing_find_mode(u8 xfer_mode)
2824 const struct ata_timing *t = ata_timing;
2826 while (xfer_mode > t->mode)
2829 if (xfer_mode == t->mode)
2834 int ata_timing_compute(struct ata_device *adev, unsigned short speed,
2835 struct ata_timing *t, int T, int UT)
2837 const struct ata_timing *s;
2838 struct ata_timing p;
2844 if (!(s = ata_timing_find_mode(speed)))
2847 memcpy(t, s, sizeof(*s));
2850 * If the drive is an EIDE drive, it can tell us it needs extended
2851 * PIO/MW_DMA cycle timing.
2854 if (adev->id[ATA_ID_FIELD_VALID] & 2) { /* EIDE drive */
2855 memset(&p, 0, sizeof(p));
2856 if (speed >= XFER_PIO_0 && speed <= XFER_SW_DMA_0) {
2857 if (speed <= XFER_PIO_2) p.cycle = p.cyc8b = adev->id[ATA_ID_EIDE_PIO];
2858 else p.cycle = p.cyc8b = adev->id[ATA_ID_EIDE_PIO_IORDY];
2859 } else if (speed >= XFER_MW_DMA_0 && speed <= XFER_MW_DMA_2) {
2860 p.cycle = adev->id[ATA_ID_EIDE_DMA_MIN];
2862 ata_timing_merge(&p, t, t, ATA_TIMING_CYCLE | ATA_TIMING_CYC8B);
2866 * Convert the timing to bus clock counts.
2869 ata_timing_quantize(t, t, T, UT);
2872 * Even in DMA/UDMA modes we still use PIO access for IDENTIFY,
2873 * S.M.A.R.T * and some other commands. We have to ensure that the
2874 * DMA cycle timing is slower/equal than the fastest PIO timing.
2877 if (speed > XFER_PIO_6) {
2878 ata_timing_compute(adev, adev->pio_mode, &p, T, UT);
2879 ata_timing_merge(&p, t, t, ATA_TIMING_ALL);
2883 * Lengthen active & recovery time so that cycle time is correct.
2886 if (t->act8b + t->rec8b < t->cyc8b) {
2887 t->act8b += (t->cyc8b - (t->act8b + t->rec8b)) / 2;
2888 t->rec8b = t->cyc8b - t->act8b;
2891 if (t->active + t->recover < t->cycle) {
2892 t->active += (t->cycle - (t->active + t->recover)) / 2;
2893 t->recover = t->cycle - t->active;
2896 /* In a few cases quantisation may produce enough errors to
2897 leave t->cycle too low for the sum of active and recovery
2898 if so we must correct this */
2899 if (t->active + t->recover > t->cycle)
2900 t->cycle = t->active + t->recover;
2906 * ata_timing_cycle2mode - find xfer mode for the specified cycle duration
2907 * @xfer_shift: ATA_SHIFT_* value for transfer type to examine.
2908 * @cycle: cycle duration in ns
2910 * Return matching xfer mode for @cycle. The returned mode is of
2911 * the transfer type specified by @xfer_shift. If @cycle is too
2912 * slow for @xfer_shift, 0xff is returned. If @cycle is faster
2913 * than the fastest known mode, the fasted mode is returned.
2919 * Matching xfer_mode, 0xff if no match found.
2921 u8 ata_timing_cycle2mode(unsigned int xfer_shift, int cycle)
2923 u8 base_mode = 0xff, last_mode = 0xff;
2924 const struct ata_xfer_ent *ent;
2925 const struct ata_timing *t;
2927 for (ent = ata_xfer_tbl; ent->shift >= 0; ent++)
2928 if (ent->shift == xfer_shift)
2929 base_mode = ent->base;
2931 for (t = ata_timing_find_mode(base_mode);
2932 t && ata_xfer_mode2shift(t->mode) == xfer_shift; t++) {
2933 unsigned short this_cycle;
2935 switch (xfer_shift) {
2937 case ATA_SHIFT_MWDMA:
2938 this_cycle = t->cycle;
2940 case ATA_SHIFT_UDMA:
2941 this_cycle = t->udma;
2947 if (cycle > this_cycle)
2950 last_mode = t->mode;
2957 * ata_down_xfermask_limit - adjust dev xfer masks downward
2958 * @dev: Device to adjust xfer masks
2959 * @sel: ATA_DNXFER_* selector
2961 * Adjust xfer masks of @dev downward. Note that this function
2962 * does not apply the change. Invoking ata_set_mode() afterwards
2963 * will apply the limit.
2966 * Inherited from caller.
2969 * 0 on success, negative errno on failure
2971 int ata_down_xfermask_limit(struct ata_device *dev, unsigned int sel)
2974 unsigned long orig_mask, xfer_mask;
2975 unsigned long pio_mask, mwdma_mask, udma_mask;
2978 quiet = !!(sel & ATA_DNXFER_QUIET);
2979 sel &= ~ATA_DNXFER_QUIET;
2981 xfer_mask = orig_mask = ata_pack_xfermask(dev->pio_mask,
2984 ata_unpack_xfermask(xfer_mask, &pio_mask, &mwdma_mask, &udma_mask);
2987 case ATA_DNXFER_PIO:
2988 highbit = fls(pio_mask) - 1;
2989 pio_mask &= ~(1 << highbit);
2992 case ATA_DNXFER_DMA:
2994 highbit = fls(udma_mask) - 1;
2995 udma_mask &= ~(1 << highbit);
2998 } else if (mwdma_mask) {
2999 highbit = fls(mwdma_mask) - 1;
3000 mwdma_mask &= ~(1 << highbit);
3006 case ATA_DNXFER_40C:
3007 udma_mask &= ATA_UDMA_MASK_40C;
3010 case ATA_DNXFER_FORCE_PIO0:
3012 case ATA_DNXFER_FORCE_PIO:
3021 xfer_mask &= ata_pack_xfermask(pio_mask, mwdma_mask, udma_mask);
3023 if (!(xfer_mask & ATA_MASK_PIO) || xfer_mask == orig_mask)
3027 if (xfer_mask & (ATA_MASK_MWDMA | ATA_MASK_UDMA))
3028 snprintf(buf, sizeof(buf), "%s:%s",
3029 ata_mode_string(xfer_mask),
3030 ata_mode_string(xfer_mask & ATA_MASK_PIO));
3032 snprintf(buf, sizeof(buf), "%s",
3033 ata_mode_string(xfer_mask));
3035 ata_dev_printk(dev, KERN_WARNING,
3036 "limiting speed to %s\n", buf);
3039 ata_unpack_xfermask(xfer_mask, &dev->pio_mask, &dev->mwdma_mask,
3045 static int ata_dev_set_mode(struct ata_device *dev)
3047 struct ata_eh_context *ehc = &dev->link->eh_context;
3048 unsigned int err_mask;
3051 dev->flags &= ~ATA_DFLAG_PIO;
3052 if (dev->xfer_shift == ATA_SHIFT_PIO)
3053 dev->flags |= ATA_DFLAG_PIO;
3055 err_mask = ata_dev_set_xfermode(dev);
3057 /* Old CFA may refuse this command, which is just fine */
3058 if (dev->xfer_shift == ATA_SHIFT_PIO && ata_id_is_cfa(dev->id))
3059 err_mask &= ~AC_ERR_DEV;
3061 /* Some very old devices and some bad newer ones fail any kind of
3062 SET_XFERMODE request but support PIO0-2 timings and no IORDY */
3063 if (dev->xfer_shift == ATA_SHIFT_PIO && !ata_id_has_iordy(dev->id) &&
3064 dev->pio_mode <= XFER_PIO_2)
3065 err_mask &= ~AC_ERR_DEV;
3067 /* Early MWDMA devices do DMA but don't allow DMA mode setting.
3068 Don't fail an MWDMA0 set IFF the device indicates it is in MWDMA0 */
3069 if (dev->xfer_shift == ATA_SHIFT_MWDMA &&
3070 dev->dma_mode == XFER_MW_DMA_0 &&
3071 (dev->id[63] >> 8) & 1)
3072 err_mask &= ~AC_ERR_DEV;
3075 ata_dev_printk(dev, KERN_ERR, "failed to set xfermode "
3076 "(err_mask=0x%x)\n", err_mask);
3080 ehc->i.flags |= ATA_EHI_POST_SETMODE;
3081 rc = ata_dev_revalidate(dev, ATA_DEV_UNKNOWN, 0);
3082 ehc->i.flags &= ~ATA_EHI_POST_SETMODE;
3086 DPRINTK("xfer_shift=%u, xfer_mode=0x%x\n",
3087 dev->xfer_shift, (int)dev->xfer_mode);
3089 ata_dev_printk(dev, KERN_INFO, "configured for %s\n",
3090 ata_mode_string(ata_xfer_mode2mask(dev->xfer_mode)));
3095 * ata_do_set_mode - Program timings and issue SET FEATURES - XFER
3096 * @link: link on which timings will be programmed
3097 * @r_failed_dev: out paramter for failed device
3099 * Standard implementation of the function used to tune and set
3100 * ATA device disk transfer mode (PIO3, UDMA6, etc.). If
3101 * ata_dev_set_mode() fails, pointer to the failing device is
3102 * returned in @r_failed_dev.
3105 * PCI/etc. bus probe sem.
3108 * 0 on success, negative errno otherwise
3111 int ata_do_set_mode(struct ata_link *link, struct ata_device **r_failed_dev)
3113 struct ata_port *ap = link->ap;
3114 struct ata_device *dev;
3115 int rc = 0, used_dma = 0, found = 0;
3117 /* step 1: calculate xfer_mask */
3118 ata_link_for_each_dev(dev, link) {
3119 unsigned long pio_mask, dma_mask;
3120 unsigned int mode_mask;
3122 if (!ata_dev_enabled(dev))
3125 mode_mask = ATA_DMA_MASK_ATA;
3126 if (dev->class == ATA_DEV_ATAPI)
3127 mode_mask = ATA_DMA_MASK_ATAPI;
3128 else if (ata_id_is_cfa(dev->id))
3129 mode_mask = ATA_DMA_MASK_CFA;
3131 ata_dev_xfermask(dev);
3133 pio_mask = ata_pack_xfermask(dev->pio_mask, 0, 0);
3134 dma_mask = ata_pack_xfermask(0, dev->mwdma_mask, dev->udma_mask);
3136 if (libata_dma_mask & mode_mask)
3137 dma_mask = ata_pack_xfermask(0, dev->mwdma_mask, dev->udma_mask);
3141 dev->pio_mode = ata_xfer_mask2mode(pio_mask);
3142 dev->dma_mode = ata_xfer_mask2mode(dma_mask);
3145 if (dev->dma_mode != 0xff)
3151 /* step 2: always set host PIO timings */
3152 ata_link_for_each_dev(dev, link) {
3153 if (!ata_dev_enabled(dev))
3156 if (dev->pio_mode == 0xff) {
3157 ata_dev_printk(dev, KERN_WARNING, "no PIO support\n");
3162 dev->xfer_mode = dev->pio_mode;
3163 dev->xfer_shift = ATA_SHIFT_PIO;
3164 if (ap->ops->set_piomode)
3165 ap->ops->set_piomode(ap, dev);
3168 /* step 3: set host DMA timings */
3169 ata_link_for_each_dev(dev, link) {