SAFE public projects git trees. - safe/jmp/linux-2.6/blob - drivers/ata/libata-acpi.c

   1 /*
   2  * libata-acpi.c
   3  * Provides ACPI support for PATA/SATA.
   4  *
   5  * Copyright (C) 2006 Intel Corp.
   6  * Copyright (C) 2006 Randy Dunlap
   7  */
   8
   9 #include <linux/module.h>
  10 #include <linux/ata.h>
  11 #include <linux/delay.h>
  12 #include <linux/device.h>
  13 #include <linux/errno.h>
  14 #include <linux/kernel.h>
  15 #include <linux/acpi.h>
  16 #include <linux/libata.h>
  17 #include <linux/pci.h>
  18 #include <scsi/scsi_device.h>
  19 #include "libata.h"
  20
  21 #include <acpi/acpi_bus.h>
  22 #include <acpi/acnames.h>
  23 #include <acpi/acnamesp.h>
  24 #include <acpi/acparser.h>
  25 #include <acpi/acexcep.h>
  26 #include <acpi/acmacros.h>
  27 #include <acpi/actypes.h>
  28
  29 enum {
  30         ATA_ACPI_FILTER_SETXFER = 1 << 0,
  31         ATA_ACPI_FILTER_LOCK    = 1 << 1,
  32
  33         ATA_ACPI_FILTER_DEFAULT = ATA_ACPI_FILTER_SETXFER |
  34                                   ATA_ACPI_FILTER_LOCK,
  35 };
  36
  37 static unsigned int ata_acpi_gtf_filter = ATA_ACPI_FILTER_DEFAULT;
  38 module_param_named(acpi_gtf_filter, ata_acpi_gtf_filter, int, 0644);
  39 MODULE_PARM_DESC(acpi_gtf_filter, "filter mask for ACPI _GTF commands, set to filter out (0x1=set xfermode, 0x2=lock/freeze lock)");
  40
  41 #define NO_PORT_MULT            0xffff
  42 #define SATA_ADR(root, pmp)     (((root) << 16) | (pmp))
  43
  44 #define REGS_PER_GTF            7
  45 struct ata_acpi_gtf {
  46         u8      tf[REGS_PER_GTF];       /* regs. 0x1f1 - 0x1f7 */
  47 } __packed;
  48
  49 /*
  50  *      Helper - belongs in the PCI layer somewhere eventually
  51  */
  52 static int is_pci_dev(struct device *dev)
  53 {
  54         return (dev->bus == &pci_bus_type);
  55 }
  56
  57 static void ata_acpi_clear_gtf(struct ata_device *dev)
  58 {
  59         kfree(dev->gtf_cache);
  60         dev->gtf_cache = NULL;
  61 }
  62
  63 /**
  64  * ata_acpi_associate_sata_port - associate SATA port with ACPI objects
  65  * @ap: target SATA port
  66  *
  67  * Look up ACPI objects associated with @ap and initialize acpi_handle
  68  * fields of @ap, the port and devices accordingly.
  69  *
  70  * LOCKING:
  71  * EH context.
  72  *
  73  * RETURNS:
  74  * 0 on success, -errno on failure.
  75  */
  76 void ata_acpi_associate_sata_port(struct ata_port *ap)
  77 {
  78         WARN_ON(!(ap->flags & ATA_FLAG_ACPI_SATA));
  79
  80         if (!ap->nr_pmp_links) {
  81                 acpi_integer adr = SATA_ADR(ap->port_no, NO_PORT_MULT);
  82
  83                 ap->link.device->acpi_handle =
  84                         acpi_get_child(ap->host->acpi_handle, adr);
  85         } else {
  86                 struct ata_link *link;
  87
  88                 ap->link.device->acpi_handle = NULL;
  89
  90                 ata_port_for_each_link(link, ap) {
  91                         acpi_integer adr = SATA_ADR(ap->port_no, link->pmp);
  92
  93                         link->device->acpi_handle =
  94                                 acpi_get_child(ap->host->acpi_handle, adr);
  95                 }
  96         }
  97 }
  98
  99 static void ata_acpi_associate_ide_port(struct ata_port *ap)
 100 {
 101         int max_devices, i;
 102
 103         ap->acpi_handle = acpi_get_child(ap->host->acpi_handle, ap->port_no);
 104         if (!ap->acpi_handle)
 105                 return;
 106
 107         max_devices = 1;
 108         if (ap->flags & ATA_FLAG_SLAVE_POSS)
 109                 max_devices++;
 110
 111         for (i = 0; i < max_devices; i++) {
 112                 struct ata_device *dev = &ap->link.device[i];
 113
 114                 dev->acpi_handle = acpi_get_child(ap->acpi_handle, i);
 115         }
 116
 117         if (ata_acpi_gtm(ap, &ap->__acpi_init_gtm) == 0)
 118                 ap->pflags |= ATA_PFLAG_INIT_GTM_VALID;
 119 }
 120
 121 static void ata_acpi_handle_hotplug(struct ata_port *ap, struct kobject *kobj,
 122                                     u32 event)
 123 {
 124         char event_string[12];
 125         char *envp[] = { event_string, NULL };
 126         struct ata_eh_info *ehi = &ap->link.eh_info;
 127
 128         if (event == 0 || event == 1) {
 129                unsigned long flags;
 130                spin_lock_irqsave(ap->lock, flags);
 131                ata_ehi_clear_desc(ehi);
 132                ata_ehi_push_desc(ehi, "ACPI event");
 133                ata_ehi_hotplugged(ehi);
 134                ata_port_freeze(ap);
 135                spin_unlock_irqrestore(ap->lock, flags);
 136         }
 137
 138         if (kobj) {
 139                 sprintf(event_string, "BAY_EVENT=%d", event);
 140                 kobject_uevent_env(kobj, KOBJ_CHANGE, envp);
 141         }
 142 }
 143
 144 static void ata_acpi_dev_notify(acpi_handle handle, u32 event, void *data)
 145 {
 146         struct ata_device *dev = data;
 147         struct kobject *kobj = NULL;
 148
 149         if (dev->sdev)
 150                 kobj = &dev->sdev->sdev_gendev.kobj;
 151
 152         ata_acpi_handle_hotplug(dev->link->ap, kobj, event);
 153 }
 154
 155 static void ata_acpi_ap_notify(acpi_handle handle, u32 event, void *data)
 156 {
 157         struct ata_port *ap = data;
 158
 159         ata_acpi_handle_hotplug(ap, &ap->dev->kobj, event);
 160 }
 161
 162 /**
 163  * ata_acpi_associate - associate ATA host with ACPI objects
 164  * @host: target ATA host
 165  *
 166  * Look up ACPI objects associated with @host and initialize
 167  * acpi_handle fields of @host, its ports and devices accordingly.
 168  *
 169  * LOCKING:
 170  * EH context.
 171  *
 172  * RETURNS:
 173  * 0 on success, -errno on failure.
 174  */
 175 void ata_acpi_associate(struct ata_host *host)
 176 {
 177         int i, j;
 178
 179         if (!is_pci_dev(host->dev) || libata_noacpi)
 180                 return;
 181
 182         host->acpi_handle = DEVICE_ACPI_HANDLE(host->dev);
 183         if (!host->acpi_handle)
 184                 return;
 185
 186         for (i = 0; i < host->n_ports; i++) {
 187                 struct ata_port *ap = host->ports[i];
 188
 189                 if (host->ports[0]->flags & ATA_FLAG_ACPI_SATA)
 190                         ata_acpi_associate_sata_port(ap);
 191                 else
 192                         ata_acpi_associate_ide_port(ap);
 193
 194                 if (ap->acpi_handle)
 195                         acpi_install_notify_handler (ap->acpi_handle,
 196                                                      ACPI_SYSTEM_NOTIFY,
 197                                                      ata_acpi_ap_notify,
 198                                                      ap);
 199
 200                 for (j = 0; j < ata_link_max_devices(&ap->link); j++) {
 201                         struct ata_device *dev = &ap->link.device[j];
 202
 203                         if (dev->acpi_handle)
 204                                 acpi_install_notify_handler (dev->acpi_handle,
 205                                                              ACPI_SYSTEM_NOTIFY,
 206                                                              ata_acpi_dev_notify,
 207                                                              dev);
 208                 }
 209         }
 210 }
 211
 212 /**
 213  * ata_acpi_dissociate - dissociate ATA host from ACPI objects
 214  * @host: target ATA host
 215  *
 216  * This function is called during driver detach after the whole host
 217  * is shut down.
 218  *
 219  * LOCKING:
 220  * EH context.
 221  */
 222 void ata_acpi_dissociate(struct ata_host *host)
 223 {
 224         int i;
 225
 226         /* Restore initial _GTM values so that driver which attaches
 227          * afterward can use them too.
 228          */
 229         for (i = 0; i < host->n_ports; i++) {
 230                 struct ata_port *ap = host->ports[i];
 231                 const struct ata_acpi_gtm *gtm = ata_acpi_init_gtm(ap);
 232
 233                 if (ap->acpi_handle && gtm)
 234                         ata_acpi_stm(ap, gtm);
 235         }
 236 }
 237
 238 /**
 239  * ata_acpi_gtm - execute _GTM
 240  * @ap: target ATA port
 241  * @gtm: out parameter for _GTM result
 242  *
 243  * Evaluate _GTM and store the result in @gtm.
 244  *
 245  * LOCKING:
 246  * EH context.
 247  *
 248  * RETURNS:
 249  * 0 on success, -ENOENT if _GTM doesn't exist, -errno on failure.
 250  */
 251 int ata_acpi_gtm(struct ata_port *ap, struct ata_acpi_gtm *gtm)
 252 {
 253         struct acpi_buffer output = { .length = ACPI_ALLOCATE_BUFFER };
 254         union acpi_object *out_obj;
 255         acpi_status status;
 256         int rc = 0;
 257
 258         status = acpi_evaluate_object(ap->acpi_handle, "_GTM", NULL, &output);
 259
 260         rc = -ENOENT;
 261         if (status == AE_NOT_FOUND)
 262                 goto out_free;
 263
 264         rc = -EINVAL;
 265         if (ACPI_FAILURE(status)) {
 266                 ata_port_printk(ap, KERN_ERR,
 267                                 "ACPI get timing mode failed (AE 0x%x)\n",
 268                                 status);
 269                 goto out_free;
 270         }
 271
 272         out_obj = output.pointer;
 273         if (out_obj->type != ACPI_TYPE_BUFFER) {
 274                 ata_port_printk(ap, KERN_WARNING,
 275                                 "_GTM returned unexpected object type 0x%x\n",
 276                                 out_obj->type);
 277
 278                 goto out_free;
 279         }
 280
 281         if (out_obj->buffer.length != sizeof(struct ata_acpi_gtm)) {
 282                 ata_port_printk(ap, KERN_ERR,
 283                                 "_GTM returned invalid length %d\n",
 284                                 out_obj->buffer.length);
 285                 goto out_free;
 286         }
 287
 288         memcpy(gtm, out_obj->buffer.pointer, sizeof(struct ata_acpi_gtm));
 289         rc = 0;
 290  out_free:
 291         kfree(output.pointer);
 292         return rc;
 293 }
 294
 295 EXPORT_SYMBOL_GPL(ata_acpi_gtm);
 296
 297 /**
 298  * ata_acpi_stm - execute _STM
 299  * @ap: target ATA port
 300  * @stm: timing parameter to _STM
 301  *
 302  * Evaluate _STM with timing parameter @stm.
 303  *
 304  * LOCKING:
 305  * EH context.
 306  *
 307  * RETURNS:
 308  * 0 on success, -ENOENT if _STM doesn't exist, -errno on failure.
 309  */
 310 int ata_acpi_stm(struct ata_port *ap, const struct ata_acpi_gtm *stm)
 311 {
 312         acpi_status status;
 313         struct ata_acpi_gtm             stm_buf = *stm;
 314         struct acpi_object_list         input;
 315         union acpi_object               in_params[3];
 316
 317         in_params[0].type = ACPI_TYPE_BUFFER;
 318         in_params[0].buffer.length = sizeof(struct ata_acpi_gtm);
 319         in_params[0].buffer.pointer = (u8 *)&stm_buf;
 320         /* Buffers for id may need byteswapping ? */
 321         in_params[1].type = ACPI_TYPE_BUFFER;
 322         in_params[1].buffer.length = 512;
 323         in_params[1].buffer.pointer = (u8 *)ap->link.device[0].id;
 324         in_params[2].type = ACPI_TYPE_BUFFER;
 325         in_params[2].buffer.length = 512;
 326         in_params[2].buffer.pointer = (u8 *)ap->link.device[1].id;
 327
 328         input.count = 3;
 329         input.pointer = in_params;
 330
 331         status = acpi_evaluate_object(ap->acpi_handle, "_STM", &input, NULL);
 332
 333         if (status == AE_NOT_FOUND)
 334                 return -ENOENT;
 335         if (ACPI_FAILURE(status)) {
 336                 ata_port_printk(ap, KERN_ERR,
 337                         "ACPI set timing mode failed (status=0x%x)\n", status);
 338                 return -EINVAL;
 339         }
 340         return 0;
 341 }
 342
 343 EXPORT_SYMBOL_GPL(ata_acpi_stm);
 344
 345 /**
 346  * ata_dev_get_GTF - get the drive bootup default taskfile settings
 347  * @dev: target ATA device
 348  * @gtf: output parameter for buffer containing _GTF taskfile arrays
 349  *
 350  * This applies to both PATA and SATA drives.
 351  *
 352  * The _GTF method has no input parameters.
 353  * It returns a variable number of register set values (registers
 354  * hex 1F1..1F7, taskfiles).
 355  * The <variable number> is not known in advance, so have ACPI-CA
 356  * allocate the buffer as needed and return it, then free it later.
 357  *
 358  * LOCKING:
 359  * EH context.
 360  *
 361  * RETURNS:
 362  * Number of taskfiles on success, 0 if _GTF doesn't exist.  -EINVAL
 363  * if _GTF is invalid.
 364  */
 365 static int ata_dev_get_GTF(struct ata_device *dev, struct ata_acpi_gtf **gtf)
 366 {
 367         struct ata_port *ap = dev->link->ap;
 368         acpi_status status;
 369         struct acpi_buffer output;
 370         union acpi_object *out_obj;
 371         int rc = 0;
 372
 373         /* if _GTF is cached, use the cached value */
 374         if (dev->gtf_cache) {
 375                 out_obj = dev->gtf_cache;
 376                 goto done;
 377         }
 378
 379         /* set up output buffer */
 380         output.length = ACPI_ALLOCATE_BUFFER;
 381         output.pointer = NULL;  /* ACPI-CA sets this; save/free it later */
 382
 383         if (ata_msg_probe(ap))
 384                 ata_dev_printk(dev, KERN_DEBUG, "%s: ENTER: port#: %d\n",
 385                                __FUNCTION__, ap->port_no);
 386
 387         /* _GTF has no input parameters */
 388         status = acpi_evaluate_object(dev->acpi_handle, "_GTF", NULL, &output);
 389         out_obj = dev->gtf_cache = output.pointer;
 390
 391         if (ACPI_FAILURE(status)) {
 392                 if (status != AE_NOT_FOUND) {
 393                         ata_dev_printk(dev, KERN_WARNING,
 394                                        "_GTF evaluation failed (AE 0x%x)\n",
 395                                        status);
 396                         rc = -EINVAL;
 397                 }
 398                 goto out_free;
 399         }
 400
 401         if (!output.length || !output.pointer) {
 402                 if (ata_msg_probe(ap))
 403                         ata_dev_printk(dev, KERN_DEBUG, "%s: Run _GTF: "
 404                                 "length or ptr is NULL (0x%llx, 0x%p)\n",
 405                                 __FUNCTION__,
 406                                 (unsigned long long)output.length,
 407                                 output.pointer);
 408                 rc = -EINVAL;
 409                 goto out_free;
 410         }
 411
 412         if (out_obj->type != ACPI_TYPE_BUFFER) {
 413                 ata_dev_printk(dev, KERN_WARNING,
 414                                "_GTF unexpected object type 0x%x\n",
 415                                out_obj->type);
 416                 rc = -EINVAL;
 417                 goto out_free;
 418         }
 419
 420         if (out_obj->buffer.length % REGS_PER_GTF) {
 421                 ata_dev_printk(dev, KERN_WARNING,
 422                                "unexpected _GTF length (%d)\n",
 423                                out_obj->buffer.length);
 424                 rc = -EINVAL;
 425                 goto out_free;
 426         }
 427
 428  done:
 429         rc = out_obj->buffer.length / REGS_PER_GTF;
 430         if (gtf) {
 431                 *gtf = (void *)out_obj->buffer.pointer;
 432                 if (ata_msg_probe(ap))
 433                         ata_dev_printk(dev, KERN_DEBUG,
 434                                        "%s: returning gtf=%p, gtf_count=%d\n",
 435                                        __FUNCTION__, *gtf, rc);
 436         }
 437         return rc;
 438
 439  out_free:
 440         ata_acpi_clear_gtf(dev);
 441         return rc;
 442 }
 443
 444 /* Welcome to ACPI, bring a bucket */
 445 const unsigned int ata_acpi_pio_cycle[7] = {
 446         600, 383, 240, 180, 120, 100, 80
 447 };
 448 EXPORT_SYMBOL_GPL(ata_acpi_pio_cycle);
 449
 450 const unsigned int ata_acpi_mwdma_cycle[5] = {
 451         480, 150, 120, 100, 80
 452 };
 453 EXPORT_SYMBOL_GPL(ata_acpi_mwdma_cycle);
 454
 455 const unsigned int ata_acpi_udma_cycle[7] = {
 456         120, 80, 60, 45, 30, 20, 15
 457 };
 458 EXPORT_SYMBOL_GPL(ata_acpi_udma_cycle);
 459
 460 /**
 461  * ata_acpi_gtm_xfermode - determine xfermode from GTM parameter
 462  * @dev: target device
 463  * @gtm: GTM parameter to use
 464  *
 465  * Determine xfermask for @dev from @gtm.
 466  *
 467  * LOCKING:
 468  * None.
 469  *
 470  * RETURNS:
 471  * Determined xfermask.
 472  */
 473 unsigned long ata_acpi_gtm_xfermask(struct ata_device *dev,
 474                                     const struct ata_acpi_gtm *gtm)
 475 {
 476         unsigned long pio_mask = 0, mwdma_mask = 0, udma_mask = 0;
 477         int unit, i;
 478         u32 t;
 479
 480         /* we always use the 0 slot for crap hardware */
 481         unit = dev->devno;
 482         if (!(gtm->flags & 0x10))
 483                 unit = 0;
 484
 485         /* Values larger than the longest cycle results in 0 mask
 486          * while values equal to smaller than the shortest cycle
 487          * results in mask which includes all supported modes.
 488          * Disabled transfer method has the value of 0xffffffff which
 489          * will always result in 0 mask.
 490          */
 491
 492         /* start by scanning for PIO modes */
 493         t = gtm->drive[unit].pio;
 494         for (i = 0; i < ARRAY_SIZE(ata_acpi_pio_cycle); i++)
 495                 if (t > ata_acpi_pio_cycle[i])
 496                         break;
 497         pio_mask = (1 << i) - 1;
 498
 499         /* See if we have MWDMA or UDMA data. We don't bother with
 500          * MWDMA if UDMA is available as this means the BIOS set UDMA
 501          * and our error changedown if it works is UDMA to PIO anyway.
 502          */
 503         t = gtm->drive[unit].dma;
 504         if (!(gtm->flags & (1 << (2 * unit)))) {
 505                 /* MWDMA */
 506                 for (i = 0; i < ARRAY_SIZE(ata_acpi_mwdma_cycle); i++)
 507                         if (t > ata_acpi_mwdma_cycle[i])
 508                                 break;
 509                 mwdma_mask = (1 << i) - 1;
 510         } else {
 511                 /* UDMA */
 512                 for (i = 0; i < ARRAY_SIZE(ata_acpi_udma_cycle); i++)
 513                         if (t > ata_acpi_udma_cycle[i])
 514                                 break;
 515                 udma_mask = (1 << i) - 1;
 516         }
 517
 518         return ata_pack_xfermask(pio_mask, mwdma_mask, udma_mask);
 519 }
 520 EXPORT_SYMBOL_GPL(ata_acpi_gtm_xfermask);
 521
 522 /**
 523  * ata_acpi_cbl_80wire          -       Check for 80 wire cable
 524  * @ap: Port to check
 525  *
 526  * Return 1 if the ACPI mode data for this port indicates the BIOS selected
 527  * an 80wire mode.
 528  */
 529
 530 int ata_acpi_cbl_80wire(struct ata_port *ap)
 531 {
 532         const struct ata_acpi_gtm *gtm = ata_acpi_init_gtm(ap);
 533         int valid = 0;
 534
 535         if (!gtm)
 536                 return 0;
 537
 538         /* Split timing, DMA enabled */
 539         if ((gtm->flags & 0x11) == 0x11 && gtm->drive[0].dma < 55)
 540                 valid |= 1;
 541         if ((gtm->flags & 0x14) == 0x14 && gtm->drive[1].dma < 55)
 542                 valid |= 2;
 543         /* Shared timing, DMA enabled */
 544         if ((gtm->flags & 0x11) == 0x01 && gtm->drive[0].dma < 55)
 545                 valid |= 1;
 546         if ((gtm->flags & 0x14) == 0x04 && gtm->drive[0].dma < 55)
 547                 valid |= 2;
 548
 549         /* Drive check */
 550         if ((valid & 1) && ata_dev_enabled(&ap->link.device[0]))
 551                 return 1;
 552         if ((valid & 2) && ata_dev_enabled(&ap->link.device[1]))
 553                 return 1;
 554         return 0;
 555 }
 556
 557 EXPORT_SYMBOL_GPL(ata_acpi_cbl_80wire);
 558
 559 static void ata_acpi_gtf_to_tf(struct ata_device *dev,
 560                                const struct ata_acpi_gtf *gtf,
 561                                struct ata_taskfile *tf)
 562 {
 563         ata_tf_init(dev, tf);
 564
 565         tf->flags |= ATA_TFLAG_ISADDR | ATA_TFLAG_DEVICE;
 566         tf->protocol = ATA_PROT_NODATA;
 567         tf->feature = gtf->tf[0];       /* 0x1f1 */
 568         tf->nsect   = gtf->tf[1];       /* 0x1f2 */
 569         tf->lbal    = gtf->tf[2];       /* 0x1f3 */
 570         tf->lbam    = gtf->tf[3];       /* 0x1f4 */
 571         tf->lbah    = gtf->tf[4];       /* 0x1f5 */
 572         tf->device  = gtf->tf[5];       /* 0x1f6 */
 573         tf->command = gtf->tf[6];       /* 0x1f7 */
 574 }
 575
 576 static int ata_acpi_filter_tf(const struct ata_taskfile *tf,
 577                               const struct ata_taskfile *ptf)
 578 {
 579         if (ata_acpi_gtf_filter & ATA_ACPI_FILTER_SETXFER) {
 580                 /* libata doesn't use ACPI to configure transfer mode.
 581                  * It will only confuse device configuration.  Skip.
 582                  */
 583                 if (tf->command == ATA_CMD_SET_FEATURES &&
 584                     tf->feature == SETFEATURES_XFER)
 585                         return 1;
 586         }
 587
 588         if (ata_acpi_gtf_filter & ATA_ACPI_FILTER_LOCK) {
 589                 /* BIOS writers, sorry but we don't wanna lock
 590                  * features unless the user explicitly said so.
 591                  */
 592
 593                 /* DEVICE CONFIGURATION FREEZE LOCK */
 594                 if (tf->command == ATA_CMD_CONF_OVERLAY &&
 595                     tf->feature == ATA_DCO_FREEZE_LOCK)
 596                         return 1;
 597
 598                 /* SECURITY FREEZE LOCK */
 599                 if (tf->command == ATA_CMD_SEC_FREEZE_LOCK)
 600                         return 1;
 601
 602                 /* SET MAX LOCK and SET MAX FREEZE LOCK */
 603                 if ((!ptf || ptf->command != ATA_CMD_READ_NATIVE_MAX) &&
 604                     tf->command == ATA_CMD_SET_MAX &&
 605                     (tf->feature == ATA_SET_MAX_LOCK ||
 606                      tf->feature == ATA_SET_MAX_FREEZE_LOCK))
 607                         return 1;
 608         }
 609
 610         return 0;
 611 }
 612
 613 /**
 614  * ata_acpi_run_tf - send taskfile registers to host controller
 615  * @dev: target ATA device
 616  * @gtf: raw ATA taskfile register set (0x1f1 - 0x1f7)
 617  *
 618  * Outputs ATA taskfile to standard ATA host controller using MMIO
 619  * or PIO as indicated by the ATA_FLAG_MMIO flag.
 620  * Writes the control, feature, nsect, lbal, lbam, and lbah registers.
 621  * Optionally (ATA_TFLAG_LBA48) writes hob_feature, hob_nsect,
 622  * hob_lbal, hob_lbam, and hob_lbah.
 623  *
 624  * This function waits for idle (!BUSY and !DRQ) after writing
 625  * registers.  If the control register has a new value, this
 626  * function also waits for idle after writing control and before
 627  * writing the remaining registers.
 628  *
 629  * LOCKING:
 630  * EH context.
 631  *
 632  * RETURNS:
 633  * 1 if command is executed successfully.  0 if ignored, rejected or
 634  * filtered out, -errno on other errors.
 635  */
 636 static int ata_acpi_run_tf(struct ata_device *dev,
 637                            const struct ata_acpi_gtf *gtf,
 638                            const struct ata_acpi_gtf *prev_gtf)
 639 {
 640         struct ata_taskfile *pptf = NULL;
 641         struct ata_taskfile tf, ptf, rtf;
 642         unsigned int err_mask;
 643         const char *level;
 644         char msg[60];
 645         int rc;
 646
 647         if ((gtf->tf[0] == 0) && (gtf->tf[1] == 0) && (gtf->tf[2] == 0)
 648             && (gtf->tf[3] == 0) && (gtf->tf[4] == 0) && (gtf->tf[5] == 0)
 649             && (gtf->tf[6] == 0))
 650                 return 0;
 651
 652         ata_acpi_gtf_to_tf(dev, gtf, &tf);
 653         if (prev_gtf) {
 654                 ata_acpi_gtf_to_tf(dev, prev_gtf, &ptf);
 655                 pptf = &ptf;
 656         }
 657
 658         if (!ata_acpi_filter_tf(&tf, pptf)) {
 659                 rtf = tf;
 660                 err_mask = ata_exec_internal(dev, &rtf, NULL,
 661                                              DMA_NONE, NULL, 0, 0);
 662
 663                 switch (err_mask) {
 664                 case 0:
 665                         level = KERN_DEBUG;
 666                         snprintf(msg, sizeof(msg), "succeeded");
 667                         rc = 1;
 668                         break;
 669
 670                 case AC_ERR_DEV:
 671                         level = KERN_INFO;
 672                         snprintf(msg, sizeof(msg),
 673                                  "rejected by device (Stat=0x%02x Err=0x%02x)",
 674                                  rtf.command, rtf.feature);
 675                         rc = 0;
 676                         break;
 677
 678                 default:
 679                         level = KERN_ERR;
 680                         snprintf(msg, sizeof(msg),
 681                                  "failed (Emask=0x%x Stat=0x%02x Err=0x%02x)",
 682                                  err_mask, rtf.command, rtf.feature);
 683                         rc = -EIO;
 684                         break;
 685                 }
 686         } else {
 687                 level = KERN_INFO;
 688                 snprintf(msg, sizeof(msg), "filtered out");
 689                 rc = 0;
 690         }
 691
 692         ata_dev_printk(dev, level,
 693                        "ACPI cmd %02x/%02x:%02x:%02x:%02x:%02x:%02x %s\n",
 694                        tf.command, tf.feature, tf.nsect, tf.lbal,
 695                        tf.lbam, tf.lbah, tf.device, msg);
 696
 697         return rc;
 698 }
 699
 700 /**
 701  * ata_acpi_exec_tfs - get then write drive taskfile settings
 702  * @dev: target ATA device
 703  * @nr_executed: out paramter for the number of executed commands
 704  *
 705  * Evaluate _GTF and excute returned taskfiles.
 706  *
 707  * LOCKING:
 708  * EH context.
 709  *
 710  * RETURNS:
 711  * Number of executed taskfiles on success, 0 if _GTF doesn't exist.
 712  * -errno on other errors.
 713  */
 714 static int ata_acpi_exec_tfs(struct ata_device *dev, int *nr_executed)
 715 {
 716         struct ata_acpi_gtf *gtf = NULL, *pgtf = NULL;
 717         int gtf_count, i, rc;
 718
 719         /* get taskfiles */
 720         rc = ata_dev_get_GTF(dev, &gtf);
 721         if (rc < 0)
 722                 return rc;
 723         gtf_count = rc;
 724
 725         /* execute them */
 726         for (i = 0; i < gtf_count; i++, gtf++) {
 727                 rc = ata_acpi_run_tf(dev, gtf, pgtf);
 728                 if (rc < 0)
 729                         break;
 730                 if (rc) {
 731                         (*nr_executed)++;
 732                         pgtf = gtf;
 733                 }
 734         }
 735
 736         ata_acpi_clear_gtf(dev);
 737
 738         if (rc < 0)
 739                 return rc;
 740         return 0;
 741 }
 742
 743 /**
 744  * ata_acpi_push_id - send Identify data to drive
 745  * @dev: target ATA device
 746  *
 747  * _SDD ACPI object: for SATA mode only
 748  * Must be after Identify (Packet) Device -- uses its data
 749  * ATM this function never returns a failure.  It is an optional
 750  * method and if it fails for whatever reason, we should still
 751  * just keep going.
 752  *
 753  * LOCKING:
 754  * EH context.
 755  *
 756  * RETURNS:
 757  * 0 on success, -errno on failure.
 758  */
 759 static int ata_acpi_push_id(struct ata_device *dev)
 760 {
 761         struct ata_port *ap = dev->link->ap;
 762         int err;
 763         acpi_status status;
 764         struct acpi_object_list input;
 765         union acpi_object in_params[1];
 766
 767         if (ata_msg_probe(ap))
 768                 ata_dev_printk(dev, KERN_DEBUG, "%s: ix = %d, port#: %d\n",
 769                                __FUNCTION__, dev->devno, ap->port_no);
 770
 771         /* Give the drive Identify data to the drive via the _SDD method */
 772         /* _SDD: set up input parameters */
 773         input.count = 1;
 774         input.pointer = in_params;
 775         in_params[0].type = ACPI_TYPE_BUFFER;
 776         in_params[0].buffer.length = sizeof(dev->id[0]) * ATA_ID_WORDS;
 777         in_params[0].buffer.pointer = (u8 *)dev->id;
 778         /* Output buffer: _SDD has no output */
 779
 780         /* It's OK for _SDD to be missing too. */
 781         swap_buf_le16(dev->id, ATA_ID_WORDS);
 782         status = acpi_evaluate_object(dev->acpi_handle, "_SDD", &input, NULL);
 783         swap_buf_le16(dev->id, ATA_ID_WORDS);
 784
 785         err = ACPI_FAILURE(status) ? -EIO : 0;
 786         if (err < 0)
 787                 ata_dev_printk(dev, KERN_WARNING,
 788                                "ACPI _SDD failed (AE 0x%x)\n", status);
 789
 790         return err;
 791 }
 792
 793 /**
 794  * ata_acpi_on_suspend - ATA ACPI hook called on suspend
 795  * @ap: target ATA port
 796  *
 797  * This function is called when @ap is about to be suspended.  All
 798  * devices are already put to sleep but the port_suspend() callback
 799  * hasn't been executed yet.  Error return from this function aborts
 800  * suspend.
 801  *
 802  * LOCKING:
 803  * EH context.
 804  *
 805  * RETURNS:
 806  * 0 on success, -errno on failure.
 807  */
 808 int ata_acpi_on_suspend(struct ata_port *ap)
 809 {
 810         /* nada */
 811         return 0;
 812 }
 813
 814 /**
 815  * ata_acpi_on_resume - ATA ACPI hook called on resume
 816  * @ap: target ATA port
 817  *
 818  * This function is called when @ap is resumed - right after port
 819  * itself is resumed but before any EH action is taken.
 820  *
 821  * LOCKING:
 822  * EH context.
 823  */
 824 void ata_acpi_on_resume(struct ata_port *ap)
 825 {
 826         const struct ata_acpi_gtm *gtm = ata_acpi_init_gtm(ap);
 827         struct ata_device *dev;
 828
 829         if (ap->acpi_handle && gtm) {
 830                 /* _GTM valid */
 831
 832                 /* restore timing parameters */
 833                 ata_acpi_stm(ap, gtm);
 834
 835                 /* _GTF should immediately follow _STM so that it can
 836                  * use values set by _STM.  Cache _GTF result and
 837                  * schedule _GTF.
 838                  */
 839                 ata_link_for_each_dev(dev, &ap->link) {
 840                         ata_acpi_clear_gtf(dev);
 841                         if (ata_dev_get_GTF(dev, NULL) >= 0)
 842                                 dev->flags |= ATA_DFLAG_ACPI_PENDING;
 843                 }
 844         } else {
 845                 /* SATA _GTF needs to be evaulated after _SDD and
 846                  * there's no reason to evaluate IDE _GTF early
 847                  * without _STM.  Clear cache and schedule _GTF.
 848                  */
 849                 ata_link_for_each_dev(dev, &ap->link) {
 850                         ata_acpi_clear_gtf(dev);
 851                         dev->flags |= ATA_DFLAG_ACPI_PENDING;
 852                 }
 853         }
 854 }
 855
 856 /**
 857  * ata_acpi_set_state - set the port power state
 858  * @ap: target ATA port
 859  * @state: state, on/off
 860  *
 861  * This function executes the _PS0/_PS3 ACPI method to set the power state.
 862  * ACPI spec requires _PS0 when IDE power on and _PS3 when power off
 863  */
 864 void ata_acpi_set_state(struct ata_port *ap, pm_message_t state)
 865 {
 866         struct ata_device *dev;
 867
 868         if (!ap->acpi_handle || (ap->flags & ATA_FLAG_ACPI_SATA))
 869                 return;
 870
 871         /* channel first and then drives for power on and vica versa
 872            for power off */
 873         if (state.event == PM_EVENT_ON)
 874                 acpi_bus_set_power(ap->acpi_handle, ACPI_STATE_D0);
 875
 876         ata_link_for_each_dev(dev, &ap->link) {
 877                 if (dev->acpi_handle && ata_dev_enabled(dev))
 878                         acpi_bus_set_power(dev->acpi_handle,
 879                                 state.event == PM_EVENT_ON ?
 880                                         ACPI_STATE_D0 : ACPI_STATE_D3);
 881         }
 882         if (state.event != PM_EVENT_ON)
 883                 acpi_bus_set_power(ap->acpi_handle, ACPI_STATE_D3);
 884 }
 885
 886 /**
 887  * ata_acpi_on_devcfg - ATA ACPI hook called on device donfiguration
 888  * @dev: target ATA device
 889  *
 890  * This function is called when @dev is about to be configured.
 891  * IDENTIFY data might have been modified after this hook is run.
 892  *
 893  * LOCKING:
 894  * EH context.
 895  *
 896  * RETURNS:
 897  * Positive number if IDENTIFY data needs to be refreshed, 0 if not,
 898  * -errno on failure.
 899  */
 900 int ata_acpi_on_devcfg(struct ata_device *dev)
 901 {
 902         struct ata_port *ap = dev->link->ap;
 903         struct ata_eh_context *ehc = &ap->link.eh_context;
 904         int acpi_sata = ap->flags & ATA_FLAG_ACPI_SATA;
 905         int nr_executed = 0;
 906         int rc;
 907
 908         if (!dev->acpi_handle)
 909                 return 0;
 910
 911         /* do we need to do _GTF? */
 912         if (!(dev->flags & ATA_DFLAG_ACPI_PENDING) &&
 913             !(acpi_sata && (ehc->i.flags & ATA_EHI_DID_HARDRESET)))
 914                 return 0;
 915
 916         /* do _SDD if SATA */
 917         if (acpi_sata) {
 918                 rc = ata_acpi_push_id(dev);
 919                 if (rc)
 920                         goto acpi_err;
 921         }
 922
 923         /* do _GTF */
 924         rc = ata_acpi_exec_tfs(dev, &nr_executed);
 925         if (rc)
 926                 goto acpi_err;
 927
 928         dev->flags &= ~ATA_DFLAG_ACPI_PENDING;
 929
 930         /* refresh IDENTIFY page if any _GTF command has been executed */
 931         if (nr_executed) {
 932                 rc = ata_dev_reread_id(dev, 0);
 933                 if (rc < 0) {
 934                         ata_dev_printk(dev, KERN_ERR, "failed to IDENTIFY "
 935                                        "after ACPI commands\n");
 936                         return rc;
 937                 }
 938         }
 939
 940         return 0;
 941
 942  acpi_err:
 943         /* ignore evaluation failure if we can continue safely */
 944         if (rc == -EINVAL && !nr_executed && !(ap->pflags & ATA_PFLAG_FROZEN))
 945                 return 0;
 946
 947         /* fail and let EH retry once more for unknown IO errors */
 948         if (!(dev->flags & ATA_DFLAG_ACPI_FAILED)) {
 949                 dev->flags |= ATA_DFLAG_ACPI_FAILED;
 950                 return rc;
 951         }
 952
 953         ata_dev_printk(dev, KERN_WARNING,
 954                        "ACPI: failed the second time, disabled\n");
 955         dev->acpi_handle = NULL;
 956
 957         /* We can safely continue if no _GTF command has been executed
 958          * and port is not frozen.
 959          */
 960         if (!nr_executed && !(ap->pflags & ATA_PFLAG_FROZEN))
 961                 return 0;
 962
 963         return rc;
 964 }
 965
 966 /**
 967  * ata_acpi_on_disable - ATA ACPI hook called when a device is disabled
 968  * @dev: target ATA device
 969  *
 970  * This function is called when @dev is about to be disabled.
 971  *
 972  * LOCKING:
 973  * EH context.
 974  */
 975 void ata_acpi_on_disable(struct ata_device *dev)
 976 {
 977         ata_acpi_clear_gtf(dev);
 978 }