2 * libata-core.c - helper library for ATA
4 * Maintained by: Tejun Heo <tj@kernel.org>
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/driver-api/libata.rst
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/time.h>
54 #include <linux/interrupt.h>
55 #include <linux/completion.h>
56 #include <linux/suspend.h>
57 #include <linux/workqueue.h>
58 #include <linux/scatterlist.h>
60 #include <linux/async.h>
61 #include <linux/log2.h>
62 #include <linux/slab.h>
63 #include <linux/glob.h>
64 #include <scsi/scsi.h>
65 #include <scsi/scsi_cmnd.h>
66 #include <scsi/scsi_host.h>
67 #include <linux/libata.h>
68 #include <asm/byteorder.h>
69 #include <asm/unaligned.h>
70 #include <linux/cdrom.h>
71 #include <linux/ratelimit.h>
72 #include <linux/leds.h>
73 #include <linux/pm_runtime.h>
74 #include <linux/platform_device.h>
76 #define CREATE_TRACE_POINTS
77 #include <trace/events/libata.h>
80 #include "libata-transport.h"
82 /* debounce timing parameters in msecs { interval, duration, timeout } */
83 const unsigned long sata_deb_timing_normal[] = { 5, 100, 2000 };
84 const unsigned long sata_deb_timing_hotplug[] = { 25, 500, 2000 };
85 const unsigned long sata_deb_timing_long[] = { 100, 2000, 5000 };
87 const struct ata_port_operations ata_base_port_ops = {
88 .prereset = ata_std_prereset,
89 .postreset = ata_std_postreset,
90 .error_handler = ata_std_error_handler,
91 .sched_eh = ata_std_sched_eh,
92 .end_eh = ata_std_end_eh,
95 const struct ata_port_operations sata_port_ops = {
96 .inherits = &ata_base_port_ops,
98 .qc_defer = ata_std_qc_defer,
99 .hardreset = sata_std_hardreset,
102 static unsigned int ata_dev_init_params(struct ata_device *dev,
103 u16 heads, u16 sectors);
104 static unsigned int ata_dev_set_xfermode(struct ata_device *dev);
105 static void ata_dev_xfermask(struct ata_device *dev);
106 static unsigned long ata_dev_blacklisted(const struct ata_device *dev);
108 atomic_t ata_print_id = ATOMIC_INIT(0);
110 struct ata_force_param {
114 unsigned long xfer_mask;
115 unsigned int horkage_on;
116 unsigned int horkage_off;
120 struct ata_force_ent {
123 struct ata_force_param param;
126 static struct ata_force_ent *ata_force_tbl;
127 static int ata_force_tbl_size;
129 static char ata_force_param_buf[PAGE_SIZE] __initdata;
130 /* param_buf is thrown away after initialization, disallow read */
131 module_param_string(force, ata_force_param_buf, sizeof(ata_force_param_buf), 0);
132 MODULE_PARM_DESC(force, "Force ATA configurations including cable type, link speed and transfer mode (see Documentation/admin-guide/kernel-parameters.rst for details)");
134 static int atapi_enabled = 1;
135 module_param(atapi_enabled, int, 0444);
136 MODULE_PARM_DESC(atapi_enabled, "Enable discovery of ATAPI devices (0=off, 1=on [default])");
138 static int atapi_dmadir = 0;
139 module_param(atapi_dmadir, int, 0444);
140 MODULE_PARM_DESC(atapi_dmadir, "Enable ATAPI DMADIR bridge support (0=off [default], 1=on)");
142 int atapi_passthru16 = 1;
143 module_param(atapi_passthru16, int, 0444);
144 MODULE_PARM_DESC(atapi_passthru16, "Enable ATA_16 passthru for ATAPI devices (0=off, 1=on [default])");
147 module_param_named(fua, libata_fua, int, 0444);
148 MODULE_PARM_DESC(fua, "FUA support (0=off [default], 1=on)");
150 static int ata_ignore_hpa;
151 module_param_named(ignore_hpa, ata_ignore_hpa, int, 0644);
152 MODULE_PARM_DESC(ignore_hpa, "Ignore HPA limit (0=keep BIOS limits, 1=ignore limits, using full disk)");
154 static int libata_dma_mask = ATA_DMA_MASK_ATA|ATA_DMA_MASK_ATAPI|ATA_DMA_MASK_CFA;
155 module_param_named(dma, libata_dma_mask, int, 0444);
156 MODULE_PARM_DESC(dma, "DMA enable/disable (0x1==ATA, 0x2==ATAPI, 0x4==CF)");
158 static int ata_probe_timeout;
159 module_param(ata_probe_timeout, int, 0444);
160 MODULE_PARM_DESC(ata_probe_timeout, "Set ATA probing timeout (seconds)");
162 int libata_noacpi = 0;
163 module_param_named(noacpi, libata_noacpi, int, 0444);
164 MODULE_PARM_DESC(noacpi, "Disable the use of ACPI in probe/suspend/resume (0=off [default], 1=on)");
166 int libata_allow_tpm = 0;
167 module_param_named(allow_tpm, libata_allow_tpm, int, 0444);
168 MODULE_PARM_DESC(allow_tpm, "Permit the use of TPM commands (0=off [default], 1=on)");
171 module_param(atapi_an, int, 0444);
172 MODULE_PARM_DESC(atapi_an, "Enable ATAPI AN media presence notification (0=0ff [default], 1=on)");
174 MODULE_AUTHOR("Jeff Garzik");
175 MODULE_DESCRIPTION("Library module for ATA devices");
176 MODULE_LICENSE("GPL");
177 MODULE_VERSION(DRV_VERSION);
180 static bool ata_sstatus_online(u32 sstatus)
182 return (sstatus & 0xf) == 0x3;
186 * ata_link_next - link iteration helper
187 * @link: the previous link, NULL to start
188 * @ap: ATA port containing links to iterate
189 * @mode: iteration mode, one of ATA_LITER_*
192 * Host lock or EH context.
195 * Pointer to the next link.
197 struct ata_link *ata_link_next(struct ata_link *link, struct ata_port *ap,
198 enum ata_link_iter_mode mode)
200 BUG_ON(mode != ATA_LITER_EDGE &&
201 mode != ATA_LITER_PMP_FIRST && mode != ATA_LITER_HOST_FIRST);
203 /* NULL link indicates start of iteration */
207 case ATA_LITER_PMP_FIRST:
208 if (sata_pmp_attached(ap))
211 case ATA_LITER_HOST_FIRST:
215 /* we just iterated over the host link, what's next? */
216 if (link == &ap->link)
218 case ATA_LITER_HOST_FIRST:
219 if (sata_pmp_attached(ap))
222 case ATA_LITER_PMP_FIRST:
223 if (unlikely(ap->slave_link))
224 return ap->slave_link;
230 /* slave_link excludes PMP */
231 if (unlikely(link == ap->slave_link))
234 /* we were over a PMP link */
235 if (++link < ap->pmp_link + ap->nr_pmp_links)
238 if (mode == ATA_LITER_PMP_FIRST)
245 * ata_dev_next - device iteration helper
246 * @dev: the previous device, NULL to start
247 * @link: ATA link containing devices to iterate
248 * @mode: iteration mode, one of ATA_DITER_*
251 * Host lock or EH context.
254 * Pointer to the next device.
256 struct ata_device *ata_dev_next(struct ata_device *dev, struct ata_link *link,
257 enum ata_dev_iter_mode mode)
259 BUG_ON(mode != ATA_DITER_ENABLED && mode != ATA_DITER_ENABLED_REVERSE &&
260 mode != ATA_DITER_ALL && mode != ATA_DITER_ALL_REVERSE);
262 /* NULL dev indicates start of iteration */
265 case ATA_DITER_ENABLED:
269 case ATA_DITER_ENABLED_REVERSE:
270 case ATA_DITER_ALL_REVERSE:
271 dev = link->device + ata_link_max_devices(link) - 1;
276 /* move to the next one */
278 case ATA_DITER_ENABLED:
280 if (++dev < link->device + ata_link_max_devices(link))
283 case ATA_DITER_ENABLED_REVERSE:
284 case ATA_DITER_ALL_REVERSE:
285 if (--dev >= link->device)
291 if ((mode == ATA_DITER_ENABLED || mode == ATA_DITER_ENABLED_REVERSE) &&
292 !ata_dev_enabled(dev))
298 * ata_dev_phys_link - find physical link for a device
299 * @dev: ATA device to look up physical link for
301 * Look up physical link which @dev is attached to. Note that
302 * this is different from @dev->link only when @dev is on slave
303 * link. For all other cases, it's the same as @dev->link.
309 * Pointer to the found physical link.
311 struct ata_link *ata_dev_phys_link(struct ata_device *dev)
313 struct ata_port *ap = dev->link->ap;
319 return ap->slave_link;
323 * ata_force_cbl - force cable type according to libata.force
324 * @ap: ATA port of interest
326 * Force cable type according to libata.force and whine about it.
327 * The last entry which has matching port number is used, so it
328 * can be specified as part of device force parameters. For
329 * example, both "a:40c,1.00:udma4" and "1.00:40c,udma4" have the
335 void ata_force_cbl(struct ata_port *ap)
339 for (i = ata_force_tbl_size - 1; i >= 0; i--) {
340 const struct ata_force_ent *fe = &ata_force_tbl[i];
342 if (fe->port != -1 && fe->port != ap->print_id)
345 if (fe->param.cbl == ATA_CBL_NONE)
348 ap->cbl = fe->param.cbl;
349 ata_port_notice(ap, "FORCE: cable set to %s\n", fe->param.name);
355 * ata_force_link_limits - force link limits according to libata.force
356 * @link: ATA link of interest
358 * Force link flags and SATA spd limit according to libata.force
359 * and whine about it. When only the port part is specified
360 * (e.g. 1:), the limit applies to all links connected to both
361 * the host link and all fan-out ports connected via PMP. If the
362 * device part is specified as 0 (e.g. 1.00:), it specifies the
363 * first fan-out link not the host link. Device number 15 always
364 * points to the host link whether PMP is attached or not. If the
365 * controller has slave link, device number 16 points to it.
370 static void ata_force_link_limits(struct ata_link *link)
372 bool did_spd = false;
373 int linkno = link->pmp;
376 if (ata_is_host_link(link))
379 for (i = ata_force_tbl_size - 1; i >= 0; i--) {
380 const struct ata_force_ent *fe = &ata_force_tbl[i];
382 if (fe->port != -1 && fe->port != link->ap->print_id)
385 if (fe->device != -1 && fe->device != linkno)
388 /* only honor the first spd limit */
389 if (!did_spd && fe->param.spd_limit) {
390 link->hw_sata_spd_limit = (1 << fe->param.spd_limit) - 1;
391 ata_link_notice(link, "FORCE: PHY spd limit set to %s\n",
396 /* let lflags stack */
397 if (fe->param.lflags) {
398 link->flags |= fe->param.lflags;
399 ata_link_notice(link,
400 "FORCE: link flag 0x%x forced -> 0x%x\n",
401 fe->param.lflags, link->flags);
407 * ata_force_xfermask - force xfermask according to libata.force
408 * @dev: ATA device of interest
410 * Force xfer_mask according to libata.force and whine about it.
411 * For consistency with link selection, device number 15 selects
412 * the first device connected to the host link.
417 static void ata_force_xfermask(struct ata_device *dev)
419 int devno = dev->link->pmp + dev->devno;
420 int alt_devno = devno;
423 /* allow n.15/16 for devices attached to host port */
424 if (ata_is_host_link(dev->link))
427 for (i = ata_force_tbl_size - 1; i >= 0; i--) {
428 const struct ata_force_ent *fe = &ata_force_tbl[i];
429 unsigned long pio_mask, mwdma_mask, udma_mask;
431 if (fe->port != -1 && fe->port != dev->link->ap->print_id)
434 if (fe->device != -1 && fe->device != devno &&
435 fe->device != alt_devno)
438 if (!fe->param.xfer_mask)
441 ata_unpack_xfermask(fe->param.xfer_mask,
442 &pio_mask, &mwdma_mask, &udma_mask);
444 dev->udma_mask = udma_mask;
445 else if (mwdma_mask) {
447 dev->mwdma_mask = mwdma_mask;
451 dev->pio_mask = pio_mask;
454 ata_dev_notice(dev, "FORCE: xfer_mask set to %s\n",
461 * ata_force_horkage - force horkage according to libata.force
462 * @dev: ATA device of interest
464 * Force horkage according to libata.force and whine about it.
465 * For consistency with link selection, device number 15 selects
466 * the first device connected to the host link.
471 static void ata_force_horkage(struct ata_device *dev)
473 int devno = dev->link->pmp + dev->devno;
474 int alt_devno = devno;
477 /* allow n.15/16 for devices attached to host port */
478 if (ata_is_host_link(dev->link))
481 for (i = 0; i < ata_force_tbl_size; i++) {
482 const struct ata_force_ent *fe = &ata_force_tbl[i];
484 if (fe->port != -1 && fe->port != dev->link->ap->print_id)
487 if (fe->device != -1 && fe->device != devno &&
488 fe->device != alt_devno)
491 if (!(~dev->horkage & fe->param.horkage_on) &&
492 !(dev->horkage & fe->param.horkage_off))
495 dev->horkage |= fe->param.horkage_on;
496 dev->horkage &= ~fe->param.horkage_off;
498 ata_dev_notice(dev, "FORCE: horkage modified (%s)\n",
504 * atapi_cmd_type - Determine ATAPI command type from SCSI opcode
505 * @opcode: SCSI opcode
507 * Determine ATAPI command type from @opcode.
513 * ATAPI_{READ|WRITE|READ_CD|PASS_THRU|MISC}
515 int atapi_cmd_type(u8 opcode)
524 case GPCMD_WRITE_AND_VERIFY_10:
528 case GPCMD_READ_CD_MSF:
529 return ATAPI_READ_CD;
533 if (atapi_passthru16)
534 return ATAPI_PASS_THRU;
542 * ata_tf_to_fis - Convert ATA taskfile to SATA FIS structure
543 * @tf: Taskfile to convert
544 * @pmp: Port multiplier port
545 * @is_cmd: This FIS is for command
546 * @fis: Buffer into which data will output
548 * Converts a standard ATA taskfile to a Serial ATA
549 * FIS structure (Register - Host to Device).
552 * Inherited from caller.
554 void ata_tf_to_fis(const struct ata_taskfile *tf, u8 pmp, int is_cmd, u8 *fis)
556 fis[0] = 0x27; /* Register - Host to Device FIS */
557 fis[1] = pmp & 0xf; /* Port multiplier number*/
559 fis[1] |= (1 << 7); /* bit 7 indicates Command FIS */
561 fis[2] = tf->command;
562 fis[3] = tf->feature;
569 fis[8] = tf->hob_lbal;
570 fis[9] = tf->hob_lbam;
571 fis[10] = tf->hob_lbah;
572 fis[11] = tf->hob_feature;
575 fis[13] = tf->hob_nsect;
579 fis[16] = tf->auxiliary & 0xff;
580 fis[17] = (tf->auxiliary >> 8) & 0xff;
581 fis[18] = (tf->auxiliary >> 16) & 0xff;
582 fis[19] = (tf->auxiliary >> 24) & 0xff;
586 * ata_tf_from_fis - Convert SATA FIS to ATA taskfile
587 * @fis: Buffer from which data will be input
588 * @tf: Taskfile to output
590 * Converts a serial ATA FIS structure to a standard ATA taskfile.
593 * Inherited from caller.
596 void ata_tf_from_fis(const u8 *fis, struct ata_taskfile *tf)
598 tf->command = fis[2]; /* status */
599 tf->feature = fis[3]; /* error */
606 tf->hob_lbal = fis[8];
607 tf->hob_lbam = fis[9];
608 tf->hob_lbah = fis[10];
611 tf->hob_nsect = fis[13];
614 static const u8 ata_rw_cmds[] = {
618 ATA_CMD_READ_MULTI_EXT,
619 ATA_CMD_WRITE_MULTI_EXT,
623 ATA_CMD_WRITE_MULTI_FUA_EXT,
627 ATA_CMD_PIO_READ_EXT,
628 ATA_CMD_PIO_WRITE_EXT,
641 ATA_CMD_WRITE_FUA_EXT
645 * ata_rwcmd_protocol - set taskfile r/w commands and protocol
646 * @tf: command to examine and configure
647 * @dev: device tf belongs to
649 * Examine the device configuration and tf->flags to calculate
650 * the proper read/write commands and protocol to use.
655 static int ata_rwcmd_protocol(struct ata_taskfile *tf, struct ata_device *dev)
659 int index, fua, lba48, write;
661 fua = (tf->flags & ATA_TFLAG_FUA) ? 4 : 0;
662 lba48 = (tf->flags & ATA_TFLAG_LBA48) ? 2 : 0;
663 write = (tf->flags & ATA_TFLAG_WRITE) ? 1 : 0;
665 if (dev->flags & ATA_DFLAG_PIO) {
666 tf->protocol = ATA_PROT_PIO;
667 index = dev->multi_count ? 0 : 8;
668 } else if (lba48 && (dev->link->ap->flags & ATA_FLAG_PIO_LBA48)) {
669 /* Unable to use DMA due to host limitation */
670 tf->protocol = ATA_PROT_PIO;
671 index = dev->multi_count ? 0 : 8;
673 tf->protocol = ATA_PROT_DMA;
677 cmd = ata_rw_cmds[index + fua + lba48 + write];
686 * ata_tf_read_block - Read block address from ATA taskfile
687 * @tf: ATA taskfile of interest
688 * @dev: ATA device @tf belongs to
693 * Read block address from @tf. This function can handle all
694 * three address formats - LBA, LBA48 and CHS. tf->protocol and
695 * flags select the address format to use.
698 * Block address read from @tf.
700 u64 ata_tf_read_block(const struct ata_taskfile *tf, struct ata_device *dev)
704 if (tf->flags & ATA_TFLAG_LBA) {
705 if (tf->flags & ATA_TFLAG_LBA48) {
706 block |= (u64)tf->hob_lbah << 40;
707 block |= (u64)tf->hob_lbam << 32;
708 block |= (u64)tf->hob_lbal << 24;
710 block |= (tf->device & 0xf) << 24;
712 block |= tf->lbah << 16;
713 block |= tf->lbam << 8;
718 cyl = tf->lbam | (tf->lbah << 8);
719 head = tf->device & 0xf;
724 "device reported invalid CHS sector 0\n");
728 block = (cyl * dev->heads + head) * dev->sectors + sect - 1;
735 * ata_build_rw_tf - Build ATA taskfile for given read/write request
736 * @tf: Target ATA taskfile
737 * @dev: ATA device @tf belongs to
738 * @block: Block address
739 * @n_block: Number of blocks
740 * @tf_flags: RW/FUA etc...
742 * @class: IO priority class
747 * Build ATA taskfile @tf for read/write request described by
748 * @block, @n_block, @tf_flags and @tag on @dev.
752 * 0 on success, -ERANGE if the request is too large for @dev,
753 * -EINVAL if the request is invalid.
755 int ata_build_rw_tf(struct ata_taskfile *tf, struct ata_device *dev,
756 u64 block, u32 n_block, unsigned int tf_flags,
757 unsigned int tag, int class)
759 tf->flags |= ATA_TFLAG_ISADDR | ATA_TFLAG_DEVICE;
760 tf->flags |= tf_flags;
762 if (ata_ncq_enabled(dev) && !ata_tag_internal(tag)) {
764 if (!lba_48_ok(block, n_block))
767 tf->protocol = ATA_PROT_NCQ;
768 tf->flags |= ATA_TFLAG_LBA | ATA_TFLAG_LBA48;
770 if (tf->flags & ATA_TFLAG_WRITE)
771 tf->command = ATA_CMD_FPDMA_WRITE;
773 tf->command = ATA_CMD_FPDMA_READ;
775 tf->nsect = tag << 3;
776 tf->hob_feature = (n_block >> 8) & 0xff;
777 tf->feature = n_block & 0xff;
779 tf->hob_lbah = (block >> 40) & 0xff;
780 tf->hob_lbam = (block >> 32) & 0xff;
781 tf->hob_lbal = (block >> 24) & 0xff;
782 tf->lbah = (block >> 16) & 0xff;
783 tf->lbam = (block >> 8) & 0xff;
784 tf->lbal = block & 0xff;
786 tf->device = ATA_LBA;
787 if (tf->flags & ATA_TFLAG_FUA)
788 tf->device |= 1 << 7;
790 if (dev->flags & ATA_DFLAG_NCQ_PRIO) {
791 if (class == IOPRIO_CLASS_RT)
792 tf->hob_nsect |= ATA_PRIO_HIGH <<
795 } else if (dev->flags & ATA_DFLAG_LBA) {
796 tf->flags |= ATA_TFLAG_LBA;
798 if (lba_28_ok(block, n_block)) {
800 tf->device |= (block >> 24) & 0xf;
801 } else if (lba_48_ok(block, n_block)) {
802 if (!(dev->flags & ATA_DFLAG_LBA48))
806 tf->flags |= ATA_TFLAG_LBA48;
808 tf->hob_nsect = (n_block >> 8) & 0xff;
810 tf->hob_lbah = (block >> 40) & 0xff;
811 tf->hob_lbam = (block >> 32) & 0xff;
812 tf->hob_lbal = (block >> 24) & 0xff;
814 /* request too large even for LBA48 */
817 if (unlikely(ata_rwcmd_protocol(tf, dev) < 0))
820 tf->nsect = n_block & 0xff;
822 tf->lbah = (block >> 16) & 0xff;
823 tf->lbam = (block >> 8) & 0xff;
824 tf->lbal = block & 0xff;
826 tf->device |= ATA_LBA;
829 u32 sect, head, cyl, track;
831 /* The request -may- be too large for CHS addressing. */
832 if (!lba_28_ok(block, n_block))
835 if (unlikely(ata_rwcmd_protocol(tf, dev) < 0))
838 /* Convert LBA to CHS */
839 track = (u32)block / dev->sectors;
840 cyl = track / dev->heads;
841 head = track % dev->heads;
842 sect = (u32)block % dev->sectors + 1;
844 DPRINTK("block %u track %u cyl %u head %u sect %u\n",
845 (u32)block, track, cyl, head, sect);
847 /* Check whether the converted CHS can fit.
851 if ((cyl >> 16) || (head >> 4) || (sect >> 8) || (!sect))
854 tf->nsect = n_block & 0xff; /* Sector count 0 means 256 sectors */
865 * ata_pack_xfermask - Pack pio, mwdma and udma masks into xfer_mask
866 * @pio_mask: pio_mask
867 * @mwdma_mask: mwdma_mask
868 * @udma_mask: udma_mask
870 * Pack @pio_mask, @mwdma_mask and @udma_mask into a single
871 * unsigned int xfer_mask.
879 unsigned long ata_pack_xfermask(unsigned long pio_mask,
880 unsigned long mwdma_mask,
881 unsigned long udma_mask)
883 return ((pio_mask << ATA_SHIFT_PIO) & ATA_MASK_PIO) |
884 ((mwdma_mask << ATA_SHIFT_MWDMA) & ATA_MASK_MWDMA) |
885 ((udma_mask << ATA_SHIFT_UDMA) & ATA_MASK_UDMA);
889 * ata_unpack_xfermask - Unpack xfer_mask into pio, mwdma and udma masks
890 * @xfer_mask: xfer_mask to unpack
891 * @pio_mask: resulting pio_mask
892 * @mwdma_mask: resulting mwdma_mask
893 * @udma_mask: resulting udma_mask
895 * Unpack @xfer_mask into @pio_mask, @mwdma_mask and @udma_mask.
896 * Any NULL destination masks will be ignored.
898 void ata_unpack_xfermask(unsigned long xfer_mask, unsigned long *pio_mask,
899 unsigned long *mwdma_mask, unsigned long *udma_mask)
902 *pio_mask = (xfer_mask & ATA_MASK_PIO) >> ATA_SHIFT_PIO;
904 *mwdma_mask = (xfer_mask & ATA_MASK_MWDMA) >> ATA_SHIFT_MWDMA;
906 *udma_mask = (xfer_mask & ATA_MASK_UDMA) >> ATA_SHIFT_UDMA;
909 static const struct ata_xfer_ent {
913 { ATA_SHIFT_PIO, ATA_NR_PIO_MODES, XFER_PIO_0 },
914 { ATA_SHIFT_MWDMA, ATA_NR_MWDMA_MODES, XFER_MW_DMA_0 },
915 { ATA_SHIFT_UDMA, ATA_NR_UDMA_MODES, XFER_UDMA_0 },
920 * ata_xfer_mask2mode - Find matching XFER_* for the given xfer_mask
921 * @xfer_mask: xfer_mask of interest
923 * Return matching XFER_* value for @xfer_mask. Only the highest
924 * bit of @xfer_mask is considered.
930 * Matching XFER_* value, 0xff if no match found.
932 u8 ata_xfer_mask2mode(unsigned long xfer_mask)
934 int highbit = fls(xfer_mask) - 1;
935 const struct ata_xfer_ent *ent;
937 for (ent = ata_xfer_tbl; ent->shift >= 0; ent++)
938 if (highbit >= ent->shift && highbit < ent->shift + ent->bits)
939 return ent->base + highbit - ent->shift;
944 * ata_xfer_mode2mask - Find matching xfer_mask for XFER_*
945 * @xfer_mode: XFER_* of interest
947 * Return matching xfer_mask for @xfer_mode.
953 * Matching xfer_mask, 0 if no match found.
955 unsigned long ata_xfer_mode2mask(u8 xfer_mode)
957 const struct ata_xfer_ent *ent;
959 for (ent = ata_xfer_tbl; ent->shift >= 0; ent++)
960 if (xfer_mode >= ent->base && xfer_mode < ent->base + ent->bits)
961 return ((2 << (ent->shift + xfer_mode - ent->base)) - 1)
962 & ~((1 << ent->shift) - 1);
967 * ata_xfer_mode2shift - Find matching xfer_shift for XFER_*
968 * @xfer_mode: XFER_* of interest
970 * Return matching xfer_shift for @xfer_mode.
976 * Matching xfer_shift, -1 if no match found.
978 int ata_xfer_mode2shift(unsigned long xfer_mode)
980 const struct ata_xfer_ent *ent;
982 for (ent = ata_xfer_tbl; ent->shift >= 0; ent++)
983 if (xfer_mode >= ent->base && xfer_mode < ent->base + ent->bits)
989 * ata_mode_string - convert xfer_mask to string
990 * @xfer_mask: mask of bits supported; only highest bit counts.
992 * Determine string which represents the highest speed
993 * (highest bit in @modemask).
999 * Constant C string representing highest speed listed in
1000 * @mode_mask, or the constant C string "<n/a>".
1002 const char *ata_mode_string(unsigned long xfer_mask)
1004 static const char * const xfer_mode_str[] = {
1028 highbit = fls(xfer_mask) - 1;
1029 if (highbit >= 0 && highbit < ARRAY_SIZE(xfer_mode_str))
1030 return xfer_mode_str[highbit];
1034 const char *sata_spd_string(unsigned int spd)
1036 static const char * const spd_str[] = {
1042 if (spd == 0 || (spd - 1) >= ARRAY_SIZE(spd_str))
1044 return spd_str[spd - 1];
1048 * ata_dev_classify - determine device type based on ATA-spec signature
1049 * @tf: ATA taskfile register set for device to be identified
1051 * Determine from taskfile register contents whether a device is
1052 * ATA or ATAPI, as per "Signature and persistence" section
1053 * of ATA/PI spec (volume 1, sect 5.14).
1059 * Device type, %ATA_DEV_ATA, %ATA_DEV_ATAPI, %ATA_DEV_PMP,
1060 * %ATA_DEV_ZAC, or %ATA_DEV_UNKNOWN the event of failure.
1062 unsigned int ata_dev_classify(const struct ata_taskfile *tf)
1064 /* Apple's open source Darwin code hints that some devices only
1065 * put a proper signature into the LBA mid/high registers,
1066 * So, we only check those. It's sufficient for uniqueness.
1068 * ATA/ATAPI-7 (d1532v1r1: Feb. 19, 2003) specified separate
1069 * signatures for ATA and ATAPI devices attached on SerialATA,
1070 * 0x3c/0xc3 and 0x69/0x96 respectively. However, SerialATA
1071 * spec has never mentioned about using different signatures
1072 * for ATA/ATAPI devices. Then, Serial ATA II: Port
1073 * Multiplier specification began to use 0x69/0x96 to identify
1074 * port multpliers and 0x3c/0xc3 to identify SEMB device.
1075 * ATA/ATAPI-7 dropped descriptions about 0x3c/0xc3 and
1076 * 0x69/0x96 shortly and described them as reserved for
1079 * We follow the current spec and consider that 0x69/0x96
1080 * identifies a port multiplier and 0x3c/0xc3 a SEMB device.
1081 * Unfortunately, WDC WD1600JS-62MHB5 (a hard drive) reports
1082 * SEMB signature. This is worked around in
1083 * ata_dev_read_id().
1085 if ((tf->lbam == 0) && (tf->lbah == 0)) {
1086 DPRINTK("found ATA device by sig\n");
1090 if ((tf->lbam == 0x14) && (tf->lbah == 0xeb)) {
1091 DPRINTK("found ATAPI device by sig\n");
1092 return ATA_DEV_ATAPI;
1095 if ((tf->lbam == 0x69) && (tf->lbah == 0x96)) {
1096 DPRINTK("found PMP device by sig\n");
1100 if ((tf->lbam == 0x3c) && (tf->lbah == 0xc3)) {
1101 DPRINTK("found SEMB device by sig (could be ATA device)\n");
1102 return ATA_DEV_SEMB;
1105 if ((tf->lbam == 0xcd) && (tf->lbah == 0xab)) {
1106 DPRINTK("found ZAC device by sig\n");
1110 DPRINTK("unknown device\n");
1111 return ATA_DEV_UNKNOWN;
1115 * ata_id_string - Convert IDENTIFY DEVICE page into string
1116 * @id: IDENTIFY DEVICE results we will examine
1117 * @s: string into which data is output
1118 * @ofs: offset into identify device page
1119 * @len: length of string to return. must be an even number.
1121 * The strings in the IDENTIFY DEVICE page are broken up into
1122 * 16-bit chunks. Run through the string, and output each
1123 * 8-bit chunk linearly, regardless of platform.
1129 void ata_id_string(const u16 *id, unsigned char *s,
1130 unsigned int ofs, unsigned int len)
1151 * ata_id_c_string - Convert IDENTIFY DEVICE page into C string
1152 * @id: IDENTIFY DEVICE results we will examine
1153 * @s: string into which data is output
1154 * @ofs: offset into identify device page
1155 * @len: length of string to return. must be an odd number.
1157 * This function is identical to ata_id_string except that it
1158 * trims trailing spaces and terminates the resulting string with
1159 * null. @len must be actual maximum length (even number) + 1.
1164 void ata_id_c_string(const u16 *id, unsigned char *s,
1165 unsigned int ofs, unsigned int len)
1169 ata_id_string(id, s, ofs, len - 1);
1171 p = s + strnlen(s, len - 1);
1172 while (p > s && p[-1] == ' ')
1177 static u64 ata_id_n_sectors(const u16 *id)
1179 if (ata_id_has_lba(id)) {
1180 if (ata_id_has_lba48(id))
1181 return ata_id_u64(id, ATA_ID_LBA_CAPACITY_2);
1183 return ata_id_u32(id, ATA_ID_LBA_CAPACITY);
1185 if (ata_id_current_chs_valid(id))
1186 return id[ATA_ID_CUR_CYLS] * id[ATA_ID_CUR_HEADS] *
1187 id[ATA_ID_CUR_SECTORS];
1189 return id[ATA_ID_CYLS] * id[ATA_ID_HEADS] *
1194 u64 ata_tf_to_lba48(const struct ata_taskfile *tf)
1198 sectors |= ((u64)(tf->hob_lbah & 0xff)) << 40;
1199 sectors |= ((u64)(tf->hob_lbam & 0xff)) << 32;
1200 sectors |= ((u64)(tf->hob_lbal & 0xff)) << 24;
1201 sectors |= (tf->lbah & 0xff) << 16;
1202 sectors |= (tf->lbam & 0xff) << 8;
1203 sectors |= (tf->lbal & 0xff);
1208 u64 ata_tf_to_lba(const struct ata_taskfile *tf)
1212 sectors |= (tf->device & 0x0f) << 24;
1213 sectors |= (tf->lbah & 0xff) << 16;
1214 sectors |= (tf->lbam & 0xff) << 8;
1215 sectors |= (tf->lbal & 0xff);
1221 * ata_read_native_max_address - Read native max address
1222 * @dev: target device
1223 * @max_sectors: out parameter for the result native max address
1225 * Perform an LBA48 or LBA28 native size query upon the device in
1229 * 0 on success, -EACCES if command is aborted by the drive.
1230 * -EIO on other errors.
1232 static int ata_read_native_max_address(struct ata_device *dev, u64 *max_sectors)
1234 unsigned int err_mask;
1235 struct ata_taskfile tf;
1236 int lba48 = ata_id_has_lba48(dev->id);
1238 ata_tf_init(dev, &tf);
1240 /* always clear all address registers */
1241 tf.flags |= ATA_TFLAG_DEVICE | ATA_TFLAG_ISADDR;
1244 tf.command = ATA_CMD_READ_NATIVE_MAX_EXT;
1245 tf.flags |= ATA_TFLAG_LBA48;
1247 tf.command = ATA_CMD_READ_NATIVE_MAX;
1249 tf.protocol = ATA_PROT_NODATA;
1250 tf.device |= ATA_LBA;
1252 err_mask = ata_exec_internal(dev, &tf, NULL, DMA_NONE, NULL, 0, 0);
1255 "failed to read native max address (err_mask=0x%x)\n",
1257 if (err_mask == AC_ERR_DEV && (tf.feature & ATA_ABORTED))
1263 *max_sectors = ata_tf_to_lba48(&tf) + 1;
1265 *max_sectors = ata_tf_to_lba(&tf) + 1;
1266 if (dev->horkage & ATA_HORKAGE_HPA_SIZE)
1272 * ata_set_max_sectors - Set max sectors
1273 * @dev: target device
1274 * @new_sectors: new max sectors value to set for the device
1276 * Set max sectors of @dev to @new_sectors.
1279 * 0 on success, -EACCES if command is aborted or denied (due to
1280 * previous non-volatile SET_MAX) by the drive. -EIO on other
1283 static int ata_set_max_sectors(struct ata_device *dev, u64 new_sectors)
1285 unsigned int err_mask;
1286 struct ata_taskfile tf;
1287 int lba48 = ata_id_has_lba48(dev->id);
1291 ata_tf_init(dev, &tf);
1293 tf.flags |= ATA_TFLAG_DEVICE | ATA_TFLAG_ISADDR;
1296 tf.command = ATA_CMD_SET_MAX_EXT;
1297 tf.flags |= ATA_TFLAG_LBA48;
1299 tf.hob_lbal = (new_sectors >> 24) & 0xff;
1300 tf.hob_lbam = (new_sectors >> 32) & 0xff;
1301 tf.hob_lbah = (new_sectors >> 40) & 0xff;
1303 tf.command = ATA_CMD_SET_MAX;
1305 tf.device |= (new_sectors >> 24) & 0xf;
1308 tf.protocol = ATA_PROT_NODATA;
1309 tf.device |= ATA_LBA;
1311 tf.lbal = (new_sectors >> 0) & 0xff;
1312 tf.lbam = (new_sectors >> 8) & 0xff;
1313 tf.lbah = (new_sectors >> 16) & 0xff;
1315 err_mask = ata_exec_internal(dev, &tf, NULL, DMA_NONE, NULL, 0, 0);
1318 "failed to set max address (err_mask=0x%x)\n",
1320 if (err_mask == AC_ERR_DEV &&
1321 (tf.feature & (ATA_ABORTED | ATA_IDNF)))
1330 * ata_hpa_resize - Resize a device with an HPA set
1331 * @dev: Device to resize
1333 * Read the size of an LBA28 or LBA48 disk with HPA features and resize
1334 * it if required to the full size of the media. The caller must check
1335 * the drive has the HPA feature set enabled.
1338 * 0 on success, -errno on failure.
1340 static int ata_hpa_resize(struct ata_device *dev)
1342 struct ata_eh_context *ehc = &dev->link->eh_context;
1343 int print_info = ehc->i.flags & ATA_EHI_PRINTINFO;
1344 bool unlock_hpa = ata_ignore_hpa || dev->flags & ATA_DFLAG_UNLOCK_HPA;
1345 u64 sectors = ata_id_n_sectors(dev->id);
1349 /* do we need to do it? */
1350 if ((dev->class != ATA_DEV_ATA && dev->class != ATA_DEV_ZAC) ||
1351 !ata_id_has_lba(dev->id) || !ata_id_hpa_enabled(dev->id) ||
1352 (dev->horkage & ATA_HORKAGE_BROKEN_HPA))
1355 /* read native max address */
1356 rc = ata_read_native_max_address(dev, &native_sectors);
1358 /* If device aborted the command or HPA isn't going to
1359 * be unlocked, skip HPA resizing.
1361 if (rc == -EACCES || !unlock_hpa) {
1363 "HPA support seems broken, skipping HPA handling\n");
1364 dev->horkage |= ATA_HORKAGE_BROKEN_HPA;
1366 /* we can continue if device aborted the command */
1373 dev->n_native_sectors = native_sectors;
1375 /* nothing to do? */
1376 if (native_sectors <= sectors || !unlock_hpa) {
1377 if (!print_info || native_sectors == sectors)
1380 if (native_sectors > sectors)
1382 "HPA detected: current %llu, native %llu\n",
1383 (unsigned long long)sectors,
1384 (unsigned long long)native_sectors);
1385 else if (native_sectors < sectors)
1387 "native sectors (%llu) is smaller than sectors (%llu)\n",
1388 (unsigned long long)native_sectors,
1389 (unsigned long long)sectors);
1393 /* let's unlock HPA */
1394 rc = ata_set_max_sectors(dev, native_sectors);
1395 if (rc == -EACCES) {
1396 /* if device aborted the command, skip HPA resizing */
1398 "device aborted resize (%llu -> %llu), skipping HPA handling\n",
1399 (unsigned long long)sectors,
1400 (unsigned long long)native_sectors);
1401 dev->horkage |= ATA_HORKAGE_BROKEN_HPA;
1406 /* re-read IDENTIFY data */
1407 rc = ata_dev_reread_id(dev, 0);
1410 "failed to re-read IDENTIFY data after HPA resizing\n");
1415 u64 new_sectors = ata_id_n_sectors(dev->id);
1417 "HPA unlocked: %llu -> %llu, native %llu\n",
1418 (unsigned long long)sectors,
1419 (unsigned long long)new_sectors,
1420 (unsigned long long)native_sectors);
1427 * ata_dump_id - IDENTIFY DEVICE info debugging output
1428 * @id: IDENTIFY DEVICE page to dump
1430 * Dump selected 16-bit words from the given IDENTIFY DEVICE
1437 static inline void ata_dump_id(const u16 *id)
1439 DPRINTK("49==0x%04x "
1449 DPRINTK("80==0x%04x "
1459 DPRINTK("88==0x%04x "
1466 * ata_id_xfermask - Compute xfermask from the given IDENTIFY data
1467 * @id: IDENTIFY data to compute xfer mask from
1469 * Compute the xfermask for this device. This is not as trivial
1470 * as it seems if we must consider early devices correctly.
1472 * FIXME: pre IDE drive timing (do we care ?).
1480 unsigned long ata_id_xfermask(const u16 *id)
1482 unsigned long pio_mask, mwdma_mask, udma_mask;
1484 /* Usual case. Word 53 indicates word 64 is valid */
1485 if (id[ATA_ID_FIELD_VALID] & (1 << 1)) {
1486 pio_mask = id[ATA_ID_PIO_MODES] & 0x03;
1490 /* If word 64 isn't valid then Word 51 high byte holds
1491 * the PIO timing number for the maximum. Turn it into
1494 u8 mode = (id[ATA_ID_OLD_PIO_MODES] >> 8) & 0xFF;
1495 if (mode < 5) /* Valid PIO range */
1496 pio_mask = (2 << mode) - 1;
1500 /* But wait.. there's more. Design your standards by
1501 * committee and you too can get a free iordy field to
1502 * process. However its the speeds not the modes that
1503 * are supported... Note drivers using the timing API
1504 * will get this right anyway
1508 mwdma_mask = id[ATA_ID_MWDMA_MODES] & 0x07;
1510 if (ata_id_is_cfa(id)) {
1512 * Process compact flash extended modes
1514 int pio = (id[ATA_ID_CFA_MODES] >> 0) & 0x7;
1515 int dma = (id[ATA_ID_CFA_MODES] >> 3) & 0x7;
1518 pio_mask |= (1 << 5);
1520 pio_mask |= (1 << 6);
1522 mwdma_mask |= (1 << 3);
1524 mwdma_mask |= (1 << 4);
1528 if (id[ATA_ID_FIELD_VALID] & (1 << 2))
1529 udma_mask = id[ATA_ID_UDMA_MODES] & 0xff;
1531 return ata_pack_xfermask(pio_mask, mwdma_mask, udma_mask);
1534 static void ata_qc_complete_internal(struct ata_queued_cmd *qc)
1536 struct completion *waiting = qc->private_data;
1542 * ata_exec_internal_sg - execute libata internal command
1543 * @dev: Device to which the command is sent
1544 * @tf: Taskfile registers for the command and the result
1545 * @cdb: CDB for packet command
1546 * @dma_dir: Data transfer direction of the command
1547 * @sgl: sg list for the data buffer of the command
1548 * @n_elem: Number of sg entries
1549 * @timeout: Timeout in msecs (0 for default)
1551 * Executes libata internal command with timeout. @tf contains
1552 * command on entry and result on return. Timeout and error
1553 * conditions are reported via return value. No recovery action
1554 * is taken after a command times out. It's caller's duty to
1555 * clean up after timeout.
1558 * None. Should be called with kernel context, might sleep.
1561 * Zero on success, AC_ERR_* mask on failure
1563 unsigned ata_exec_internal_sg(struct ata_device *dev,
1564 struct ata_taskfile *tf, const u8 *cdb,
1565 int dma_dir, struct scatterlist *sgl,
1566 unsigned int n_elem, unsigned long timeout)
1568 struct ata_link *link = dev->link;
1569 struct ata_port *ap = link->ap;
1570 u8 command = tf->command;
1571 int auto_timeout = 0;
1572 struct ata_queued_cmd *qc;
1573 unsigned int preempted_tag;
1574 u32 preempted_sactive;
1575 u64 preempted_qc_active;
1576 int preempted_nr_active_links;
1577 DECLARE_COMPLETION_ONSTACK(wait);
1578 unsigned long flags;
1579 unsigned int err_mask;
1582 spin_lock_irqsave(ap->lock, flags);
1584 /* no internal command while frozen */
1585 if (ap->pflags & ATA_PFLAG_FROZEN) {
1586 spin_unlock_irqrestore(ap->lock, flags);
1587 return AC_ERR_SYSTEM;
1590 /* initialize internal qc */
1591 qc = __ata_qc_from_tag(ap, ATA_TAG_INTERNAL);
1593 qc->tag = ATA_TAG_INTERNAL;
1600 preempted_tag = link->active_tag;
1601 preempted_sactive = link->sactive;
1602 preempted_qc_active = ap->qc_active;
1603 preempted_nr_active_links = ap->nr_active_links;
1604 link->active_tag = ATA_TAG_POISON;
1607 ap->nr_active_links = 0;
1609 /* prepare & issue qc */
1612 memcpy(qc->cdb, cdb, ATAPI_CDB_LEN);
1614 /* some SATA bridges need us to indicate data xfer direction */
1615 if (tf->protocol == ATAPI_PROT_DMA && (dev->flags & ATA_DFLAG_DMADIR) &&
1616 dma_dir == DMA_FROM_DEVICE)
1617 qc->tf.feature |= ATAPI_DMADIR;
1619 qc->flags |= ATA_QCFLAG_RESULT_TF;
1620 qc->dma_dir = dma_dir;
1621 if (dma_dir != DMA_NONE) {
1622 unsigned int i, buflen = 0;
1623 struct scatterlist *sg;
1625 for_each_sg(sgl, sg, n_elem, i)
1626 buflen += sg->length;
1628 ata_sg_init(qc, sgl, n_elem);
1629 qc->nbytes = buflen;
1632 qc->private_data = &wait;
1633 qc->complete_fn = ata_qc_complete_internal;
1637 spin_unlock_irqrestore(ap->lock, flags);
1640 if (ata_probe_timeout)
1641 timeout = ata_probe_timeout * 1000;
1643 timeout = ata_internal_cmd_timeout(dev, command);
1648 if (ap->ops->error_handler)
1651 rc = wait_for_completion_timeout(&wait, msecs_to_jiffies(timeout));
1653 if (ap->ops->error_handler)
1656 ata_sff_flush_pio_task(ap);
1659 spin_lock_irqsave(ap->lock, flags);
1661 /* We're racing with irq here. If we lose, the
1662 * following test prevents us from completing the qc
1663 * twice. If we win, the port is frozen and will be
1664 * cleaned up by ->post_internal_cmd().
1666 if (qc->flags & ATA_QCFLAG_ACTIVE) {
1667 qc->err_mask |= AC_ERR_TIMEOUT;
1669 if (ap->ops->error_handler)
1670 ata_port_freeze(ap);
1672 ata_qc_complete(qc);
1674 if (ata_msg_warn(ap))
1675 ata_dev_warn(dev, "qc timeout (cmd 0x%x)\n",
1679 spin_unlock_irqrestore(ap->lock, flags);
1682 /* do post_internal_cmd */
1683 if (ap->ops->post_internal_cmd)
1684 ap->ops->post_internal_cmd(qc);
1686 /* perform minimal error analysis */
1687 if (qc->flags & ATA_QCFLAG_FAILED) {
1688 if (qc->result_tf.command & (ATA_ERR | ATA_DF))
1689 qc->err_mask |= AC_ERR_DEV;
1692 qc->err_mask |= AC_ERR_OTHER;
1694 if (qc->err_mask & ~AC_ERR_OTHER)
1695 qc->err_mask &= ~AC_ERR_OTHER;
1696 } else if (qc->tf.command == ATA_CMD_REQ_SENSE_DATA) {
1697 qc->result_tf.command |= ATA_SENSE;
1701 spin_lock_irqsave(ap->lock, flags);
1703 *tf = qc->result_tf;
1704 err_mask = qc->err_mask;
1707 link->active_tag = preempted_tag;
1708 link->sactive = preempted_sactive;
1709 ap->qc_active = preempted_qc_active;
1710 ap->nr_active_links = preempted_nr_active_links;
1712 spin_unlock_irqrestore(ap->lock, flags);
1714 if ((err_mask & AC_ERR_TIMEOUT) && auto_timeout)
1715 ata_internal_cmd_timed_out(dev, command);
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 transfer 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_pio_need_iordy - check if iordy needed
1762 * Check if the current speed of the device requires IORDY. Used
1763 * by various controllers for chip configuration.
1765 unsigned int ata_pio_need_iordy(const struct ata_device *adev)
1767 /* Don't set IORDY if we're preparing for reset. IORDY may
1768 * lead to controller lock up on certain controllers if the
1769 * port is not occupied. See bko#11703 for details.
1771 if (adev->link->ap->pflags & ATA_PFLAG_RESETTING)
1773 /* Controller doesn't support IORDY. Probably a pointless
1774 * check as the caller should know this.
1776 if (adev->link->ap->flags & ATA_FLAG_NO_IORDY)
1778 /* CF spec. r4.1 Table 22 says no iordy on PIO5 and PIO6. */
1779 if (ata_id_is_cfa(adev->id)
1780 && (adev->pio_mode == XFER_PIO_5 || adev->pio_mode == XFER_PIO_6))
1782 /* PIO3 and higher it is mandatory */
1783 if (adev->pio_mode > XFER_PIO_2)
1785 /* We turn it on when possible */
1786 if (ata_id_has_iordy(adev->id))
1792 * ata_pio_mask_no_iordy - Return the non IORDY mask
1795 * Compute the highest mode possible if we are not using iordy. Return
1796 * -1 if no iordy mode is available.
1798 static u32 ata_pio_mask_no_iordy(const struct ata_device *adev)
1800 /* If we have no drive specific rule, then PIO 2 is non IORDY */
1801 if (adev->id[ATA_ID_FIELD_VALID] & 2) { /* EIDE */
1802 u16 pio = adev->id[ATA_ID_EIDE_PIO];
1803 /* Is the speed faster than the drive allows non IORDY ? */
1805 /* This is cycle times not frequency - watch the logic! */
1806 if (pio > 240) /* PIO2 is 240nS per cycle */
1807 return 3 << ATA_SHIFT_PIO;
1808 return 7 << ATA_SHIFT_PIO;
1811 return 3 << ATA_SHIFT_PIO;
1815 * ata_do_dev_read_id - default ID read method
1817 * @tf: proposed taskfile
1820 * Issue the identify taskfile and hand back the buffer containing
1821 * identify data. For some RAID controllers and for pre ATA devices
1822 * this function is wrapped or replaced by the driver
1824 unsigned int ata_do_dev_read_id(struct ata_device *dev,
1825 struct ata_taskfile *tf, u16 *id)
1827 return ata_exec_internal(dev, tf, NULL, DMA_FROM_DEVICE,
1828 id, sizeof(id[0]) * ATA_ID_WORDS, 0);
1832 * ata_dev_read_id - Read ID data from the specified device
1833 * @dev: target device
1834 * @p_class: pointer to class of the target device (may be changed)
1835 * @flags: ATA_READID_* flags
1836 * @id: buffer to read IDENTIFY data into
1838 * Read ID data from the specified device. ATA_CMD_ID_ATA is
1839 * performed on ATA devices and ATA_CMD_ID_ATAPI on ATAPI
1840 * devices. This function also issues ATA_CMD_INIT_DEV_PARAMS
1841 * for pre-ATA4 drives.
1843 * FIXME: ATA_CMD_ID_ATA is optional for early drives and right
1844 * now we abort if we hit that case.
1847 * Kernel thread context (may sleep)
1850 * 0 on success, -errno otherwise.
1852 int ata_dev_read_id(struct ata_device *dev, unsigned int *p_class,
1853 unsigned int flags, u16 *id)
1855 struct ata_port *ap = dev->link->ap;
1856 unsigned int class = *p_class;
1857 struct ata_taskfile tf;
1858 unsigned int err_mask = 0;
1860 bool is_semb = class == ATA_DEV_SEMB;
1861 int may_fallback = 1, tried_spinup = 0;
1864 if (ata_msg_ctl(ap))
1865 ata_dev_dbg(dev, "%s: ENTER\n", __func__);
1868 ata_tf_init(dev, &tf);
1872 class = ATA_DEV_ATA; /* some hard drives report SEMB sig */
1876 tf.command = ATA_CMD_ID_ATA;
1879 tf.command = ATA_CMD_ID_ATAPI;
1883 reason = "unsupported class";
1887 tf.protocol = ATA_PROT_PIO;
1889 /* Some devices choke if TF registers contain garbage. Make
1890 * sure those are properly initialized.
1892 tf.flags |= ATA_TFLAG_ISADDR | ATA_TFLAG_DEVICE;
1894 /* Device presence detection is unreliable on some
1895 * controllers. Always poll IDENTIFY if available.
1897 tf.flags |= ATA_TFLAG_POLLING;
1899 if (ap->ops->read_id)
1900 err_mask = ap->ops->read_id(dev, &tf, id);
1902 err_mask = ata_do_dev_read_id(dev, &tf, id);
1905 if (err_mask & AC_ERR_NODEV_HINT) {
1906 ata_dev_dbg(dev, "NODEV after polling detection\n");
1912 "IDENTIFY failed on device w/ SEMB sig, disabled\n");
1913 /* SEMB is not supported yet */
1914 *p_class = ATA_DEV_SEMB_UNSUP;
1918 if ((err_mask == AC_ERR_DEV) && (tf.feature & ATA_ABORTED)) {
1919 /* Device or controller might have reported
1920 * the wrong device class. Give a shot at the
1921 * other IDENTIFY if the current one is
1922 * aborted by the device.
1927 if (class == ATA_DEV_ATA)
1928 class = ATA_DEV_ATAPI;
1930 class = ATA_DEV_ATA;
1934 /* Control reaches here iff the device aborted
1935 * both flavors of IDENTIFYs which happens
1936 * sometimes with phantom devices.
1939 "both IDENTIFYs aborted, assuming NODEV\n");
1944 reason = "I/O error";
1948 if (dev->horkage & ATA_HORKAGE_DUMP_ID) {
1949 ata_dev_dbg(dev, "dumping IDENTIFY data, "
1950 "class=%d may_fallback=%d tried_spinup=%d\n",
1951 class, may_fallback, tried_spinup);
1952 print_hex_dump(KERN_DEBUG, "", DUMP_PREFIX_OFFSET,
1953 16, 2, id, ATA_ID_WORDS * sizeof(*id), true);
1956 /* Falling back doesn't make sense if ID data was read
1957 * successfully at least once.
1961 swap_buf_le16(id, ATA_ID_WORDS);
1965 reason = "device reports invalid type";
1967 if (class == ATA_DEV_ATA || class == ATA_DEV_ZAC) {
1968 if (!ata_id_is_ata(id) && !ata_id_is_cfa(id))
1970 if (ap->host->flags & ATA_HOST_IGNORE_ATA &&
1971 ata_id_is_ata(id)) {
1973 "host indicates ignore ATA devices, ignored\n");
1977 if (ata_id_is_ata(id))
1981 if (!tried_spinup && (id[2] == 0x37c8 || id[2] == 0x738c)) {
1984 * Drive powered-up in standby mode, and requires a specific
1985 * SET_FEATURES spin-up subcommand before it will accept
1986 * anything other than the original IDENTIFY command.
1988 err_mask = ata_dev_set_feature(dev, SETFEATURES_SPINUP, 0);
1989 if (err_mask && id[2] != 0x738c) {
1991 reason = "SPINUP failed";
1995 * If the drive initially returned incomplete IDENTIFY info,
1996 * we now must reissue the IDENTIFY command.
1998 if (id[2] == 0x37c8)
2002 if ((flags & ATA_READID_POSTRESET) &&
2003 (class == ATA_DEV_ATA || class == ATA_DEV_ZAC)) {
2005 * The exact sequence expected by certain pre-ATA4 drives is:
2007 * IDENTIFY (optional in early ATA)
2008 * INITIALIZE DEVICE PARAMETERS (later IDE and ATA)
2010 * Some drives were very specific about that exact sequence.
2012 * Note that ATA4 says lba is mandatory so the second check
2013 * should never trigger.
2015 if (ata_id_major_version(id) < 4 || !ata_id_has_lba(id)) {
2016 err_mask = ata_dev_init_params(dev, id[3], id[6]);
2019 reason = "INIT_DEV_PARAMS failed";
2023 /* current CHS translation info (id[53-58]) might be
2024 * changed. reread the identify device info.
2026 flags &= ~ATA_READID_POSTRESET;
2036 if (ata_msg_warn(ap))
2037 ata_dev_warn(dev, "failed to IDENTIFY (%s, err_mask=0x%x)\n",
2043 * ata_read_log_page - read a specific log page
2044 * @dev: target device
2046 * @page: page to read
2047 * @buf: buffer to store read page
2048 * @sectors: number of sectors to read
2050 * Read log page using READ_LOG_EXT command.
2053 * Kernel thread context (may sleep).
2056 * 0 on success, AC_ERR_* mask otherwise.
2058 unsigned int ata_read_log_page(struct ata_device *dev, u8 log,
2059 u8 page, void *buf, unsigned int sectors)
2061 unsigned long ap_flags = dev->link->ap->flags;
2062 struct ata_taskfile tf;
2063 unsigned int err_mask;
2066 DPRINTK("read log page - log 0x%x, page 0x%x\n", log, page);
2069 * Return error without actually issuing the command on controllers
2070 * which e.g. lockup on a read log page.
2072 if (ap_flags & ATA_FLAG_NO_LOG_PAGE)
2076 ata_tf_init(dev, &tf);
2077 if (dev->dma_mode && ata_id_has_read_log_dma_ext(dev->id) &&
2078 !(dev->horkage & ATA_HORKAGE_NO_DMA_LOG)) {
2079 tf.command = ATA_CMD_READ_LOG_DMA_EXT;
2080 tf.protocol = ATA_PROT_DMA;
2083 tf.command = ATA_CMD_READ_LOG_EXT;
2084 tf.protocol = ATA_PROT_PIO;
2090 tf.hob_nsect = sectors >> 8;
2091 tf.flags |= ATA_TFLAG_ISADDR | ATA_TFLAG_LBA48 | ATA_TFLAG_DEVICE;
2093 err_mask = ata_exec_internal(dev, &tf, NULL, DMA_FROM_DEVICE,
2094 buf, sectors * ATA_SECT_SIZE, 0);
2096 if (err_mask && dma) {
2097 dev->horkage |= ATA_HORKAGE_NO_DMA_LOG;
2098 ata_dev_warn(dev, "READ LOG DMA EXT failed, trying PIO\n");
2102 DPRINTK("EXIT, err_mask=%x\n", err_mask);
2106 static bool ata_log_supported(struct ata_device *dev, u8 log)
2108 struct ata_port *ap = dev->link->ap;
2110 if (ata_read_log_page(dev, ATA_LOG_DIRECTORY, 0, ap->sector_buf, 1))
2112 return get_unaligned_le16(&ap->sector_buf[log * 2]) ? true : false;
2115 static bool ata_identify_page_supported(struct ata_device *dev, u8 page)
2117 struct ata_port *ap = dev->link->ap;
2118 unsigned int err, i;
2120 if (!ata_log_supported(dev, ATA_LOG_IDENTIFY_DEVICE)) {
2121 ata_dev_warn(dev, "ATA Identify Device Log not supported\n");
2126 * Read IDENTIFY DEVICE data log, page 0, to figure out if the page is
2129 err = ata_read_log_page(dev, ATA_LOG_IDENTIFY_DEVICE, 0, ap->sector_buf,
2133 "failed to get Device Identify Log Emask 0x%x\n",
2138 for (i = 0; i < ap->sector_buf[8]; i++) {
2139 if (ap->sector_buf[9 + i] == page)
2146 static int ata_do_link_spd_horkage(struct ata_device *dev)
2148 struct ata_link *plink = ata_dev_phys_link(dev);
2149 u32 target, target_limit;
2151 if (!sata_scr_valid(plink))
2154 if (dev->horkage & ATA_HORKAGE_1_5_GBPS)
2159 target_limit = (1 << target) - 1;
2161 /* if already on stricter limit, no need to push further */
2162 if (plink->sata_spd_limit <= target_limit)
2165 plink->sata_spd_limit = target_limit;
2167 /* Request another EH round by returning -EAGAIN if link is
2168 * going faster than the target speed. Forward progress is
2169 * guaranteed by setting sata_spd_limit to target_limit above.
2171 if (plink->sata_spd > target) {
2172 ata_dev_info(dev, "applying link speed limit horkage to %s\n",
2173 sata_spd_string(target));
2179 static inline u8 ata_dev_knobble(struct ata_device *dev)
2181 struct ata_port *ap = dev->link->ap;
2183 if (ata_dev_blacklisted(dev) & ATA_HORKAGE_BRIDGE_OK)
2186 return ((ap->cbl == ATA_CBL_SATA) && (!ata_id_is_sata(dev->id)));
2189 static void ata_dev_config_ncq_send_recv(struct ata_device *dev)
2191 struct ata_port *ap = dev->link->ap;
2192 unsigned int err_mask;
2194 if (!ata_log_supported(dev, ATA_LOG_NCQ_SEND_RECV)) {
2195 ata_dev_warn(dev, "NCQ Send/Recv Log not supported\n");
2198 err_mask = ata_read_log_page(dev, ATA_LOG_NCQ_SEND_RECV,
2199 0, ap->sector_buf, 1);
2202 "failed to get NCQ Send/Recv Log Emask 0x%x\n",
2205 u8 *cmds = dev->ncq_send_recv_cmds;
2207 dev->flags |= ATA_DFLAG_NCQ_SEND_RECV;
2208 memcpy(cmds, ap->sector_buf, ATA_LOG_NCQ_SEND_RECV_SIZE);
2210 if (dev->horkage & ATA_HORKAGE_NO_NCQ_TRIM) {
2211 ata_dev_dbg(dev, "disabling queued TRIM support\n");
2212 cmds[ATA_LOG_NCQ_SEND_RECV_DSM_OFFSET] &=
2213 ~ATA_LOG_NCQ_SEND_RECV_DSM_TRIM;
2218 static void ata_dev_config_ncq_non_data(struct ata_device *dev)
2220 struct ata_port *ap = dev->link->ap;
2221 unsigned int err_mask;
2223 if (!ata_log_supported(dev, ATA_LOG_NCQ_NON_DATA)) {
2225 "NCQ Send/Recv Log not supported\n");
2228 err_mask = ata_read_log_page(dev, ATA_LOG_NCQ_NON_DATA,
2229 0, ap->sector_buf, 1);
2232 "failed to get NCQ Non-Data Log Emask 0x%x\n",
2235 u8 *cmds = dev->ncq_non_data_cmds;
2237 memcpy(cmds, ap->sector_buf, ATA_LOG_NCQ_NON_DATA_SIZE);
2241 static void ata_dev_config_ncq_prio(struct ata_device *dev)
2243 struct ata_port *ap = dev->link->ap;
2244 unsigned int err_mask;
2246 if (!(dev->flags & ATA_DFLAG_NCQ_PRIO_ENABLE)) {
2247 dev->flags &= ~ATA_DFLAG_NCQ_PRIO;
2251 err_mask = ata_read_log_page(dev,
2252 ATA_LOG_IDENTIFY_DEVICE,
2253 ATA_LOG_SATA_SETTINGS,
2258 "failed to get Identify Device data, Emask 0x%x\n",
2263 if (ap->sector_buf[ATA_LOG_NCQ_PRIO_OFFSET] & BIT(3)) {
2264 dev->flags |= ATA_DFLAG_NCQ_PRIO;
2266 dev->flags &= ~ATA_DFLAG_NCQ_PRIO;
2267 ata_dev_dbg(dev, "SATA page does not support priority\n");
2272 static int ata_dev_config_ncq(struct ata_device *dev,
2273 char *desc, size_t desc_sz)
2275 struct ata_port *ap = dev->link->ap;
2276 int hdepth = 0, ddepth = ata_id_queue_depth(dev->id);
2277 unsigned int err_mask;
2280 if (!ata_id_has_ncq(dev->id)) {
2284 if (dev->horkage & ATA_HORKAGE_NONCQ) {
2285 snprintf(desc, desc_sz, "NCQ (not used)");
2288 if (ap->flags & ATA_FLAG_NCQ) {
2289 hdepth = min(ap->scsi_host->can_queue, ATA_MAX_QUEUE);
2290 dev->flags |= ATA_DFLAG_NCQ;
2293 if (!(dev->horkage & ATA_HORKAGE_BROKEN_FPDMA_AA) &&
2294 (ap->flags & ATA_FLAG_FPDMA_AA) &&
2295 ata_id_has_fpdma_aa(dev->id)) {
2296 err_mask = ata_dev_set_feature(dev, SETFEATURES_SATA_ENABLE,
2300 "failed to enable AA (error_mask=0x%x)\n",
2302 if (err_mask != AC_ERR_DEV) {
2303 dev->horkage |= ATA_HORKAGE_BROKEN_FPDMA_AA;
2310 if (hdepth >= ddepth)
2311 snprintf(desc, desc_sz, "NCQ (depth %d)%s", ddepth, aa_desc);
2313 snprintf(desc, desc_sz, "NCQ (depth %d/%d)%s", hdepth,
2316 if ((ap->flags & ATA_FLAG_FPDMA_AUX)) {
2317 if (ata_id_has_ncq_send_and_recv(dev->id))
2318 ata_dev_config_ncq_send_recv(dev);
2319 if (ata_id_has_ncq_non_data(dev->id))
2320 ata_dev_config_ncq_non_data(dev);
2321 if (ata_id_has_ncq_prio(dev->id))
2322 ata_dev_config_ncq_prio(dev);
2328 static void ata_dev_config_sense_reporting(struct ata_device *dev)
2330 unsigned int err_mask;
2332 if (!ata_id_has_sense_reporting(dev->id))
2335 if (ata_id_sense_reporting_enabled(dev->id))
2338 err_mask = ata_dev_set_feature(dev, SETFEATURE_SENSE_DATA, 0x1);
2341 "failed to enable Sense Data Reporting, Emask 0x%x\n",
2346 static void ata_dev_config_zac(struct ata_device *dev)
2348 struct ata_port *ap = dev->link->ap;
2349 unsigned int err_mask;
2350 u8 *identify_buf = ap->sector_buf;
2352 dev->zac_zones_optimal_open = U32_MAX;
2353 dev->zac_zones_optimal_nonseq = U32_MAX;
2354 dev->zac_zones_max_open = U32_MAX;
2357 * Always set the 'ZAC' flag for Host-managed devices.
2359 if (dev->class == ATA_DEV_ZAC)
2360 dev->flags |= ATA_DFLAG_ZAC;
2361 else if (ata_id_zoned_cap(dev->id) == 0x01)
2363 * Check for host-aware devices.
2365 dev->flags |= ATA_DFLAG_ZAC;
2367 if (!(dev->flags & ATA_DFLAG_ZAC))
2370 if (!ata_identify_page_supported(dev, ATA_LOG_ZONED_INFORMATION)) {
2372 "ATA Zoned Information Log not supported\n");
2377 * Read IDENTIFY DEVICE data log, page 9 (Zoned-device information)
2379 err_mask = ata_read_log_page(dev, ATA_LOG_IDENTIFY_DEVICE,
2380 ATA_LOG_ZONED_INFORMATION,
2383 u64 zoned_cap, opt_open, opt_nonseq, max_open;
2385 zoned_cap = get_unaligned_le64(&identify_buf[8]);
2386 if ((zoned_cap >> 63))
2387 dev->zac_zoned_cap = (zoned_cap & 1);
2388 opt_open = get_unaligned_le64(&identify_buf[24]);
2389 if ((opt_open >> 63))
2390 dev->zac_zones_optimal_open = (u32)opt_open;
2391 opt_nonseq = get_unaligned_le64(&identify_buf[32]);
2392 if ((opt_nonseq >> 63))
2393 dev->zac_zones_optimal_nonseq = (u32)opt_nonseq;
2394 max_open = get_unaligned_le64(&identify_buf[40]);
2395 if ((max_open >> 63))
2396 dev->zac_zones_max_open = (u32)max_open;
2400 static void ata_dev_config_trusted(struct ata_device *dev)
2402 struct ata_port *ap = dev->link->ap;
2406 if (!ata_id_has_trusted(dev->id))
2409 if (!ata_identify_page_supported(dev, ATA_LOG_SECURITY)) {
2411 "Security Log not supported\n");
2415 err = ata_read_log_page(dev, ATA_LOG_IDENTIFY_DEVICE, ATA_LOG_SECURITY,
2419 "failed to read Security Log, Emask 0x%x\n", err);
2423 trusted_cap = get_unaligned_le64(&ap->sector_buf[40]);
2424 if (!(trusted_cap & (1ULL << 63))) {
2426 "Trusted Computing capability qword not valid!\n");
2430 if (trusted_cap & (1 << 0))
2431 dev->flags |= ATA_DFLAG_TRUSTED;
2435 * ata_dev_configure - Configure the specified ATA/ATAPI device
2436 * @dev: Target device to configure
2438 * Configure @dev according to @dev->id. Generic and low-level
2439 * driver specific fixups are also applied.
2442 * Kernel thread context (may sleep)
2445 * 0 on success, -errno otherwise
2447 int ata_dev_configure(struct ata_device *dev)
2449 struct ata_port *ap = dev->link->ap;
2450 struct ata_eh_context *ehc = &dev->link->eh_context;
2451 int print_info = ehc->i.flags & ATA_EHI_PRINTINFO;
2452 const u16 *id = dev->id;
2453 unsigned long xfer_mask;
2454 unsigned int err_mask;
2455 char revbuf[7]; /* XYZ-99\0 */
2456 char fwrevbuf[ATA_ID_FW_REV_LEN+1];
2457 char modelbuf[ATA_ID_PROD_LEN+1];
2460 if (!ata_dev_enabled(dev) && ata_msg_info(ap)) {
2461 ata_dev_info(dev, "%s: ENTER/EXIT -- nodev\n", __func__);
2465 if (ata_msg_probe(ap))
2466 ata_dev_dbg(dev, "%s: ENTER\n", __func__);
2469 dev->horkage |= ata_dev_blacklisted(dev);
2470 ata_force_horkage(dev);
2472 if (dev->horkage & ATA_HORKAGE_DISABLE) {
2473 ata_dev_info(dev, "unsupported device, disabling\n");
2474 ata_dev_disable(dev);
2478 if ((!atapi_enabled || (ap->flags & ATA_FLAG_NO_ATAPI)) &&
2479 dev->class == ATA_DEV_ATAPI) {
2480 ata_dev_warn(dev, "WARNING: ATAPI is %s, device ignored\n",
2481 atapi_enabled ? "not supported with this driver"
2483 ata_dev_disable(dev);
2487 rc = ata_do_link_spd_horkage(dev);
2491 /* some WD SATA-1 drives have issues with LPM, turn on NOLPM for them */
2492 if ((dev->horkage & ATA_HORKAGE_WD_BROKEN_LPM) &&
2493 (id[ATA_ID_SATA_CAPABILITY] & 0xe) == 0x2)
2494 dev->horkage |= ATA_HORKAGE_NOLPM;
2496 if (ap->flags & ATA_FLAG_NO_LPM)
2497 dev->horkage |= ATA_HORKAGE_NOLPM;
2499 if (dev->horkage & ATA_HORKAGE_NOLPM) {
2500 ata_dev_warn(dev, "LPM support broken, forcing max_power\n");
2501 dev->link->ap->target_lpm_policy = ATA_LPM_MAX_POWER;
2504 /* let ACPI work its magic */
2505 rc = ata_acpi_on_devcfg(dev);
2509 /* massage HPA, do it early as it might change IDENTIFY data */
2510 rc = ata_hpa_resize(dev);
2514 /* print device capabilities */
2515 if (ata_msg_probe(ap))
2517 "%s: cfg 49:%04x 82:%04x 83:%04x 84:%04x "
2518 "85:%04x 86:%04x 87:%04x 88:%04x\n",
2520 id[49], id[82], id[83], id[84],
2521 id[85], id[86], id[87], id[88]);
2523 /* initialize to-be-configured parameters */
2524 dev->flags &= ~ATA_DFLAG_CFG_MASK;
2525 dev->max_sectors = 0;
2531 dev->multi_count = 0;
2534 * common ATA, ATAPI feature tests
2537 /* find max transfer mode; for printk only */
2538 xfer_mask = ata_id_xfermask(id);
2540 if (ata_msg_probe(ap))
2543 /* SCSI only uses 4-char revisions, dump full 8 chars from ATA */
2544 ata_id_c_string(dev->id, fwrevbuf, ATA_ID_FW_REV,
2547 ata_id_c_string(dev->id, modelbuf, ATA_ID_PROD,
2550 /* ATA-specific feature tests */
2551 if (dev->class == ATA_DEV_ATA || dev->class == ATA_DEV_ZAC) {
2552 if (ata_id_is_cfa(id)) {
2553 /* CPRM may make this media unusable */
2554 if (id[ATA_ID_CFA_KEY_MGMT] & 1)
2556 "supports DRM functions and may not be fully accessible\n");
2557 snprintf(revbuf, 7, "CFA");
2559 snprintf(revbuf, 7, "ATA-%d", ata_id_major_version(id));
2560 /* Warn the user if the device has TPM extensions */
2561 if (ata_id_has_tpm(id))
2563 "supports DRM functions and may not be fully accessible\n");
2566 dev->n_sectors = ata_id_n_sectors(id);
2568 /* get current R/W Multiple count setting */
2569 if ((dev->id[47] >> 8) == 0x80 && (dev->id[59] & 0x100)) {
2570 unsigned int max = dev->id[47] & 0xff;
2571 unsigned int cnt = dev->id[59] & 0xff;
2572 /* only recognize/allow powers of two here */
2573 if (is_power_of_2(max) && is_power_of_2(cnt))
2575 dev->multi_count = cnt;
2578 if (ata_id_has_lba(id)) {
2579 const char *lba_desc;
2583 dev->flags |= ATA_DFLAG_LBA;
2584 if (ata_id_has_lba48(id)) {
2585 dev->flags |= ATA_DFLAG_LBA48;
2588 if (dev->n_sectors >= (1UL << 28) &&
2589 ata_id_has_flush_ext(id))
2590 dev->flags |= ATA_DFLAG_FLUSH_EXT;
2594 rc = ata_dev_config_ncq(dev, ncq_desc, sizeof(ncq_desc));
2598 /* print device info to dmesg */
2599 if (ata_msg_drv(ap) && print_info) {
2600 ata_dev_info(dev, "%s: %s, %s, max %s\n",
2601 revbuf, modelbuf, fwrevbuf,
2602 ata_mode_string(xfer_mask));
2604 "%llu sectors, multi %u: %s %s\n",
2605 (unsigned long long)dev->n_sectors,
2606 dev->multi_count, lba_desc, ncq_desc);
2611 /* Default translation */
2612 dev->cylinders = id[1];
2614 dev->sectors = id[6];
2616 if (ata_id_current_chs_valid(id)) {
2617 /* Current CHS translation is valid. */
2618 dev->cylinders = id[54];
2619 dev->heads = id[55];
2620 dev->sectors = id[56];
2623 /* print device info to dmesg */
2624 if (ata_msg_drv(ap) && print_info) {
2625 ata_dev_info(dev, "%s: %s, %s, max %s\n",
2626 revbuf, modelbuf, fwrevbuf,
2627 ata_mode_string(xfer_mask));
2629 "%llu sectors, multi %u, CHS %u/%u/%u\n",
2630 (unsigned long long)dev->n_sectors,
2631 dev->multi_count, dev->cylinders,
2632 dev->heads, dev->sectors);
2636 /* Check and mark DevSlp capability. Get DevSlp timing variables
2637 * from SATA Settings page of Identify Device Data Log.
2639 if (ata_id_has_devslp(dev->id)) {
2640 u8 *sata_setting = ap->sector_buf;
2643 dev->flags |= ATA_DFLAG_DEVSLP;
2644 err_mask = ata_read_log_page(dev,
2645 ATA_LOG_IDENTIFY_DEVICE,
2646 ATA_LOG_SATA_SETTINGS,
2651 "failed to get Identify Device Data, Emask 0x%x\n",
2654 for (i = 0; i < ATA_LOG_DEVSLP_SIZE; i++) {
2655 j = ATA_LOG_DEVSLP_OFFSET + i;
2656 dev->devslp_timing[i] = sata_setting[j];
2659 ata_dev_config_sense_reporting(dev);
2660 ata_dev_config_zac(dev);
2661 ata_dev_config_trusted(dev);
2665 /* ATAPI-specific feature tests */
2666 else if (dev->class == ATA_DEV_ATAPI) {
2667 const char *cdb_intr_string = "";
2668 const char *atapi_an_string = "";
2669 const char *dma_dir_string = "";
2672 rc = atapi_cdb_len(id);
2673 if ((rc < 12) || (rc > ATAPI_CDB_LEN)) {
2674 if (ata_msg_warn(ap))
2675 ata_dev_warn(dev, "unsupported CDB len\n");
2679 dev->cdb_len = (unsigned int) rc;
2681 /* Enable ATAPI AN if both the host and device have
2682 * the support. If PMP is attached, SNTF is required
2683 * to enable ATAPI AN to discern between PHY status
2684 * changed notifications and ATAPI ANs.
2687 (ap->flags & ATA_FLAG_AN) && ata_id_has_atapi_AN(id) &&
2688 (!sata_pmp_attached(ap) ||
2689 sata_scr_read(&ap->link, SCR_NOTIFICATION, &sntf) == 0)) {
2690 /* issue SET feature command to turn this on */
2691 err_mask = ata_dev_set_feature(dev,
2692 SETFEATURES_SATA_ENABLE, SATA_AN);
2695 "failed to enable ATAPI AN (err_mask=0x%x)\n",
2698 dev->flags |= ATA_DFLAG_AN;
2699 atapi_an_string = ", ATAPI AN";
2703 if (ata_id_cdb_intr(dev->id)) {
2704 dev->flags |= ATA_DFLAG_CDB_INTR;
2705 cdb_intr_string = ", CDB intr";
2708 if (atapi_dmadir || (dev->horkage & ATA_HORKAGE_ATAPI_DMADIR) || atapi_id_dmadir(dev->id)) {
2709 dev->flags |= ATA_DFLAG_DMADIR;
2710 dma_dir_string = ", DMADIR";
2713 if (ata_id_has_da(dev->id)) {
2714 dev->flags |= ATA_DFLAG_DA;
2718 /* print device info to dmesg */
2719 if (ata_msg_drv(ap) && print_info)
2721 "ATAPI: %s, %s, max %s%s%s%s\n",
2723 ata_mode_string(xfer_mask),
2724 cdb_intr_string, atapi_an_string,
2728 /* determine max_sectors */
2729 dev->max_sectors = ATA_MAX_SECTORS;
2730 if (dev->flags & ATA_DFLAG_LBA48)
2731 dev->max_sectors = ATA_MAX_SECTORS_LBA48;
2733 /* Limit PATA drive on SATA cable bridge transfers to udma5,
2735 if (ata_dev_knobble(dev)) {
2736 if (ata_msg_drv(ap) && print_info)
2737 ata_dev_info(dev, "applying bridge limits\n");
2738 dev->udma_mask &= ATA_UDMA5;
2739 dev->max_sectors = ATA_MAX_SECTORS;
2742 if ((dev->class == ATA_DEV_ATAPI) &&
2743 (atapi_command_packet_set(id) == TYPE_TAPE)) {
2744 dev->max_sectors = ATA_MAX_SECTORS_TAPE;
2745 dev->horkage |= ATA_HORKAGE_STUCK_ERR;
2748 if (dev->horkage & ATA_HORKAGE_MAX_SEC_128)
2749 dev->max_sectors = min_t(unsigned int, ATA_MAX_SECTORS_128,
2752 if (dev->horkage & ATA_HORKAGE_MAX_SEC_1024)
2753 dev->max_sectors = min_t(unsigned int, ATA_MAX_SECTORS_1024,
2756 if (dev->horkage & ATA_HORKAGE_MAX_SEC_LBA48)
2757 dev->max_sectors = ATA_MAX_SECTORS_LBA48;
2759 if (ap->ops->dev_config)
2760 ap->ops->dev_config(dev);
2762 if (dev->horkage & ATA_HORKAGE_DIAGNOSTIC) {
2763 /* Let the user know. We don't want to disallow opens for
2764 rescue purposes, or in case the vendor is just a blithering
2765 idiot. Do this after the dev_config call as some controllers
2766 with buggy firmware may want to avoid reporting false device
2771 "Drive reports diagnostics failure. This may indicate a drive\n");
2773 "fault or invalid emulation. Contact drive vendor for information.\n");
2777 if ((dev->horkage & ATA_HORKAGE_FIRMWARE_WARN) && print_info) {
2778 ata_dev_warn(dev, "WARNING: device requires firmware update to be fully functional\n");
2779 ata_dev_warn(dev, " contact the vendor or visit http://ata.wiki.kernel.org\n");
2785 if (ata_msg_probe(ap))
2786 ata_dev_dbg(dev, "%s: EXIT, err\n", __func__);
2791 * ata_cable_40wire - return 40 wire cable type
2794 * Helper method for drivers which want to hardwire 40 wire cable
2798 int ata_cable_40wire(struct ata_port *ap)
2800 return ATA_CBL_PATA40;
2804 * ata_cable_80wire - return 80 wire cable type
2807 * Helper method for drivers which want to hardwire 80 wire cable
2811 int ata_cable_80wire(struct ata_port *ap)
2813 return ATA_CBL_PATA80;
2817 * ata_cable_unknown - return unknown PATA cable.
2820 * Helper method for drivers which have no PATA cable detection.
2823 int ata_cable_unknown(struct ata_port *ap)
2825 return ATA_CBL_PATA_UNK;
2829 * ata_cable_ignore - return ignored PATA cable.
2832 * Helper method for drivers which don't use cable type to limit
2835 int ata_cable_ignore(struct ata_port *ap)
2837 return ATA_CBL_PATA_IGN;
2841 * ata_cable_sata - return SATA cable type
2844 * Helper method for drivers which have SATA cables
2847 int ata_cable_sata(struct ata_port *ap)
2849 return ATA_CBL_SATA;
2853 * ata_bus_probe - Reset and probe ATA bus
2856 * Master ATA bus probing function. Initiates a hardware-dependent
2857 * bus reset, then attempts to identify any devices found on
2861 * PCI/etc. bus probe sem.
2864 * Zero on success, negative errno otherwise.
2867 int ata_bus_probe(struct ata_port *ap)
2869 unsigned int classes[ATA_MAX_DEVICES];
2870 int tries[ATA_MAX_DEVICES];
2872 struct ata_device *dev;
2874 ata_for_each_dev(dev, &ap->link, ALL)
2875 tries[dev->devno] = ATA_PROBE_MAX_TRIES;
2878 ata_for_each_dev(dev, &ap->link, ALL) {
2879 /* If we issue an SRST then an ATA drive (not ATAPI)
2880 * may change configuration and be in PIO0 timing. If
2881 * we do a hard reset (or are coming from power on)
2882 * this is true for ATA or ATAPI. Until we've set a
2883 * suitable controller mode we should not touch the
2884 * bus as we may be talking too fast.
2886 dev->pio_mode = XFER_PIO_0;
2887 dev->dma_mode = 0xff;
2889 /* If the controller has a pio mode setup function
2890 * then use it to set the chipset to rights. Don't
2891 * touch the DMA setup as that will be dealt with when
2892 * configuring devices.
2894 if (ap->ops->set_piomode)
2895 ap->ops->set_piomode(ap, dev);
2898 /* reset and determine device classes */
2899 ap->ops->phy_reset(ap);
2901 ata_for_each_dev(dev, &ap->link, ALL) {
2902 if (dev->class != ATA_DEV_UNKNOWN)
2903 classes[dev->devno] = dev->class;
2905 classes[dev->devno] = ATA_DEV_NONE;
2907 dev->class = ATA_DEV_UNKNOWN;
2910 /* read IDENTIFY page and configure devices. We have to do the identify
2911 specific sequence bass-ackwards so that PDIAG- is released by
2914 ata_for_each_dev(dev, &ap->link, ALL_REVERSE) {
2915 if (tries[dev->devno])
2916 dev->class = classes[dev->devno];
2918 if (!ata_dev_enabled(dev))
2921 rc = ata_dev_read_id(dev, &dev->class, ATA_READID_POSTRESET,
2927 /* Now ask for the cable type as PDIAG- should have been released */
2928 if (ap->ops->cable_detect)
2929 ap->cbl = ap->ops->cable_detect(ap);
2931 /* We may have SATA bridge glue hiding here irrespective of
2932 * the reported cable types and sensed types. When SATA
2933 * drives indicate we have a bridge, we don't know which end
2934 * of the link the bridge is which is a problem.
2936 ata_for_each_dev(dev, &ap->link, ENABLED)
2937 if (ata_id_is_sata(dev->id))
2938 ap->cbl = ATA_CBL_SATA;
2940 /* After the identify sequence we can now set up the devices. We do
2941 this in the normal order so that the user doesn't get confused */
2943 ata_for_each_dev(dev, &ap->link, ENABLED) {
2944 ap->link.eh_context.i.flags |= ATA_EHI_PRINTINFO;
2945 rc = ata_dev_configure(dev);
2946 ap->link.eh_context.i.flags &= ~ATA_EHI_PRINTINFO;
2951 /* configure transfer mode */
2952 rc = ata_set_mode(&ap->link, &dev);
2956 ata_for_each_dev(dev, &ap->link, ENABLED)
2962 tries[dev->devno]--;
2966 /* eeek, something went very wrong, give up */
2967 tries[dev->devno] = 0;
2971 /* give it just one more chance */
2972 tries[dev->devno] = min(tries[dev->devno], 1);
2975 if (tries[dev->devno] == 1) {
2976 /* This is the last chance, better to slow
2977 * down than lose it.
2979 sata_down_spd_limit(&ap->link, 0);
2980 ata_down_xfermask_limit(dev, ATA_DNXFER_PIO);
2984 if (!tries[dev->devno])
2985 ata_dev_disable(dev);
2991 * sata_print_link_status - Print SATA link status
2992 * @link: SATA link to printk link status about
2994 * This function prints link speed and status of a SATA link.
2999 static void sata_print_link_status(struct ata_link *link)
3001 u32 sstatus, scontrol, tmp;
3003 if (sata_scr_read(link, SCR_STATUS, &sstatus))
3005 sata_scr_read(link, SCR_CONTROL, &scontrol);
3007 if (ata_phys_link_online(link)) {
3008 tmp = (sstatus >> 4) & 0xf;
3009 ata_link_info(link, "SATA link up %s (SStatus %X SControl %X)\n",
3010 sata_spd_string(tmp), sstatus, scontrol);
3012 ata_link_info(link, "SATA link down (SStatus %X SControl %X)\n",
3018 * ata_dev_pair - return other device on cable
3021 * Obtain the other device on the same cable, or if none is
3022 * present NULL is returned
3025 struct ata_device *ata_dev_pair(struct ata_device *adev)
3027 struct ata_link *link = adev->link;
3028 struct ata_device *pair = &link->device[1 - adev->devno];
3029 if (!ata_dev_enabled(pair))
3035 * sata_down_spd_limit - adjust SATA spd limit downward
3036 * @link: Link to adjust SATA spd limit for
3037 * @spd_limit: Additional limit
3039 * Adjust SATA spd limit of @link downward. Note that this
3040 * function only adjusts the limit. The change must be applied
3041 * using sata_set_spd().
3043 * If @spd_limit is non-zero, the speed is limited to equal to or
3044 * lower than @spd_limit if such speed is supported. If
3045 * @spd_limit is slower than any supported speed, only the lowest
3046 * supported speed is allowed.
3049 * Inherited from caller.
3052 * 0 on success, negative errno on failure
3054 int sata_down_spd_limit(struct ata_link *link, u32 spd_limit)
3056 u32 sstatus, spd, mask;
3059 if (!sata_scr_valid(link))
3062 /* If SCR can be read, use it to determine the current SPD.
3063 * If not, use cached value in link->sata_spd.
3065 rc = sata_scr_read(link, SCR_STATUS, &sstatus);
3066 if (rc == 0 && ata_sstatus_online(sstatus))
3067 spd = (sstatus >> 4) & 0xf;
3069 spd = link->sata_spd;
3071 mask = link->sata_spd_limit;
3075 /* unconditionally mask off the highest bit */
3076 bit = fls(mask) - 1;
3077 mask &= ~(1 << bit);
3080 * Mask off all speeds higher than or equal to the current one. At
3081 * this point, if current SPD is not available and we previously
3082 * recorded the link speed from SStatus, the driver has already
3083 * masked off the highest bit so mask should already be 1 or 0.
3084 * Otherwise, we should not force 1.5Gbps on a link where we have
3085 * not previously recorded speed from SStatus. Just return in this
3089 mask &= (1 << (spd - 1)) - 1;
3093 /* were we already at the bottom? */
3098 if (mask & ((1 << spd_limit) - 1))
3099 mask &= (1 << spd_limit) - 1;
3101 bit = ffs(mask) - 1;
3106 link->sata_spd_limit = mask;
3108 ata_link_warn(link, "limiting SATA link speed to %s\n",
3109 sata_spd_string(fls(mask)));
3114 static int __sata_set_spd_needed(struct ata_link *link, u32 *scontrol)
3116 struct ata_link *host_link = &link->ap->link;
3117 u32 limit, target, spd;
3119 limit = link->sata_spd_limit;
3121 /* Don't configure downstream link faster than upstream link.
3122 * It doesn't speed up anything and some PMPs choke on such
3125 if (!ata_is_host_link(link) && host_link->sata_spd)
3126 limit &= (1 << host_link->sata_spd) - 1;
3128 if (limit == UINT_MAX)
3131 target = fls(limit);
3133 spd = (*scontrol >> 4) & 0xf;
3134 *scontrol = (*scontrol & ~0xf0) | ((target & 0xf) << 4);
3136 return spd != target;
3140 * sata_set_spd_needed - is SATA spd configuration needed
3141 * @link: Link in question
3143 * Test whether the spd limit in SControl matches
3144 * @link->sata_spd_limit. This function is used to determine
3145 * whether hardreset is necessary to apply SATA spd
3149 * Inherited from caller.
3152 * 1 if SATA spd configuration is needed, 0 otherwise.
3154 static int sata_set_spd_needed(struct ata_link *link)
3158 if (sata_scr_read(link, SCR_CONTROL, &scontrol))
3161 return __sata_set_spd_needed(link, &scontrol);
3165 * sata_set_spd - set SATA spd according to spd limit
3166 * @link: Link to set SATA spd for
3168 * Set SATA spd of @link according to sata_spd_limit.
3171 * Inherited from caller.
3174 * 0 if spd doesn't need to be changed, 1 if spd has been
3175 * changed. Negative errno if SCR registers are inaccessible.
3177 int sata_set_spd(struct ata_link *link)
3182 if ((rc = sata_scr_read(link, SCR_CONTROL, &scontrol)))
3185 if (!__sata_set_spd_needed(link, &scontrol))
3188 if ((rc = sata_scr_write(link, SCR_CONTROL, scontrol)))