1 // SPDX-License-Identifier: GPL-2.0-or-later 2 /* 3 * AHCI SATA platform library 4 * 5 * Copyright 2004-2005 Red Hat, Inc. 6 * Jeff Garzik <jgarzik@pobox.com> 7 * Copyright 2010 MontaVista Software, LLC. 8 * Anton Vorontsov <avorontsov@ru.mvista.com> 9 */ 10 11 #include <linux/clk.h> 12 #include <linux/kernel.h> 13 #include <linux/gfp.h> 14 #include <linux/module.h> 15 #include <linux/pm.h> 16 #include <linux/interrupt.h> 17 #include <linux/device.h> 18 #include <linux/platform_device.h> 19 #include <linux/libata.h> 20 #include <linux/ahci_platform.h> 21 #include <linux/phy/phy.h> 22 #include <linux/pm_runtime.h> 23 #include <linux/of_platform.h> 24 #include <linux/reset.h> 25 #include "ahci.h" 26 27 static void ahci_host_stop(struct ata_host *host); 28 29 struct ata_port_operations ahci_platform_ops = { 30 .inherits = &ahci_ops, 31 .host_stop = ahci_host_stop, 32 }; 33 EXPORT_SYMBOL_GPL(ahci_platform_ops); 34 35 /** 36 * ahci_platform_enable_phys - Enable PHYs 37 * @hpriv: host private area to store config values 38 * 39 * This function enables all the PHYs found in hpriv->phys, if any. 40 * If a PHY fails to be enabled, it disables all the PHYs already 41 * enabled in reverse order and returns an error. 42 * 43 * RETURNS: 44 * 0 on success otherwise a negative error code 45 */ 46 static int ahci_platform_enable_phys(struct ahci_host_priv *hpriv) 47 { 48 int rc, i; 49 50 for (i = 0; i < hpriv->nports; i++) { 51 rc = phy_init(hpriv->phys[i]); 52 if (rc) 53 goto disable_phys; 54 55 rc = phy_set_mode(hpriv->phys[i], PHY_MODE_SATA); 56 if (rc) { 57 phy_exit(hpriv->phys[i]); 58 goto disable_phys; 59 } 60 61 rc = phy_power_on(hpriv->phys[i]); 62 if (rc) { 63 phy_exit(hpriv->phys[i]); 64 goto disable_phys; 65 } 66 } 67 68 return 0; 69 70 disable_phys: 71 while (--i >= 0) { 72 phy_power_off(hpriv->phys[i]); 73 phy_exit(hpriv->phys[i]); 74 } 75 return rc; 76 } 77 78 /** 79 * ahci_platform_disable_phys - Disable PHYs 80 * @hpriv: host private area to store config values 81 * 82 * This function disables all PHYs found in hpriv->phys. 83 */ 84 static void ahci_platform_disable_phys(struct ahci_host_priv *hpriv) 85 { 86 int i; 87 88 for (i = 0; i < hpriv->nports; i++) { 89 phy_power_off(hpriv->phys[i]); 90 phy_exit(hpriv->phys[i]); 91 } 92 } 93 94 /** 95 * ahci_platform_enable_clks - Enable platform clocks 96 * @hpriv: host private area to store config values 97 * 98 * This function enables all the clks found in hpriv->clks, starting at 99 * index 0. If any clk fails to enable it disables all the clks already 100 * enabled in reverse order, and then returns an error. 101 * 102 * RETURNS: 103 * 0 on success otherwise a negative error code 104 */ 105 int ahci_platform_enable_clks(struct ahci_host_priv *hpriv) 106 { 107 int c, rc; 108 109 for (c = 0; c < AHCI_MAX_CLKS && hpriv->clks[c]; c++) { 110 rc = clk_prepare_enable(hpriv->clks[c]); 111 if (rc) 112 goto disable_unprepare_clk; 113 } 114 return 0; 115 116 disable_unprepare_clk: 117 while (--c >= 0) 118 clk_disable_unprepare(hpriv->clks[c]); 119 return rc; 120 } 121 EXPORT_SYMBOL_GPL(ahci_platform_enable_clks); 122 123 /** 124 * ahci_platform_disable_clks - Disable platform clocks 125 * @hpriv: host private area to store config values 126 * 127 * This function disables all the clks found in hpriv->clks, in reverse 128 * order of ahci_platform_enable_clks (starting at the end of the array). 129 */ 130 void ahci_platform_disable_clks(struct ahci_host_priv *hpriv) 131 { 132 int c; 133 134 for (c = AHCI_MAX_CLKS - 1; c >= 0; c--) 135 if (hpriv->clks[c]) 136 clk_disable_unprepare(hpriv->clks[c]); 137 } 138 EXPORT_SYMBOL_GPL(ahci_platform_disable_clks); 139 140 /** 141 * ahci_platform_enable_regulators - Enable regulators 142 * @hpriv: host private area to store config values 143 * 144 * This function enables all the regulators found in controller and 145 * hpriv->target_pwrs, if any. If a regulator fails to be enabled, it 146 * disables all the regulators already enabled in reverse order and 147 * returns an error. 148 * 149 * RETURNS: 150 * 0 on success otherwise a negative error code 151 */ 152 int ahci_platform_enable_regulators(struct ahci_host_priv *hpriv) 153 { 154 int rc, i; 155 156 if (hpriv->ahci_regulator) { 157 rc = regulator_enable(hpriv->ahci_regulator); 158 if (rc) 159 return rc; 160 } 161 162 if (hpriv->phy_regulator) { 163 rc = regulator_enable(hpriv->phy_regulator); 164 if (rc) 165 goto disable_ahci_pwrs; 166 } 167 168 for (i = 0; i < hpriv->nports; i++) { 169 if (!hpriv->target_pwrs[i]) 170 continue; 171 172 rc = regulator_enable(hpriv->target_pwrs[i]); 173 if (rc) 174 goto disable_target_pwrs; 175 } 176 177 return 0; 178 179 disable_target_pwrs: 180 while (--i >= 0) 181 if (hpriv->target_pwrs[i]) 182 regulator_disable(hpriv->target_pwrs[i]); 183 184 if (hpriv->phy_regulator) 185 regulator_disable(hpriv->phy_regulator); 186 disable_ahci_pwrs: 187 if (hpriv->ahci_regulator) 188 regulator_disable(hpriv->ahci_regulator); 189 return rc; 190 } 191 EXPORT_SYMBOL_GPL(ahci_platform_enable_regulators); 192 193 /** 194 * ahci_platform_disable_regulators - Disable regulators 195 * @hpriv: host private area to store config values 196 * 197 * This function disables all regulators found in hpriv->target_pwrs and 198 * AHCI controller. 199 */ 200 void ahci_platform_disable_regulators(struct ahci_host_priv *hpriv) 201 { 202 int i; 203 204 for (i = 0; i < hpriv->nports; i++) { 205 if (!hpriv->target_pwrs[i]) 206 continue; 207 regulator_disable(hpriv->target_pwrs[i]); 208 } 209 210 if (hpriv->ahci_regulator) 211 regulator_disable(hpriv->ahci_regulator); 212 if (hpriv->phy_regulator) 213 regulator_disable(hpriv->phy_regulator); 214 } 215 EXPORT_SYMBOL_GPL(ahci_platform_disable_regulators); 216 /** 217 * ahci_platform_enable_resources - Enable platform resources 218 * @hpriv: host private area to store config values 219 * 220 * This function enables all ahci_platform managed resources in the 221 * following order: 222 * 1) Regulator 223 * 2) Clocks (through ahci_platform_enable_clks) 224 * 3) Resets 225 * 4) Phys 226 * 227 * If resource enabling fails at any point the previous enabled resources 228 * are disabled in reverse order. 229 * 230 * RETURNS: 231 * 0 on success otherwise a negative error code 232 */ 233 int ahci_platform_enable_resources(struct ahci_host_priv *hpriv) 234 { 235 int rc; 236 237 rc = ahci_platform_enable_regulators(hpriv); 238 if (rc) 239 return rc; 240 241 rc = ahci_platform_enable_clks(hpriv); 242 if (rc) 243 goto disable_regulator; 244 245 rc = reset_control_deassert(hpriv->rsts); 246 if (rc) 247 goto disable_clks; 248 249 rc = ahci_platform_enable_phys(hpriv); 250 if (rc) 251 goto disable_resets; 252 253 return 0; 254 255 disable_resets: 256 reset_control_assert(hpriv->rsts); 257 258 disable_clks: 259 ahci_platform_disable_clks(hpriv); 260 261 disable_regulator: 262 ahci_platform_disable_regulators(hpriv); 263 264 return rc; 265 } 266 EXPORT_SYMBOL_GPL(ahci_platform_enable_resources); 267 268 /** 269 * ahci_platform_disable_resources - Disable platform resources 270 * @hpriv: host private area to store config values 271 * 272 * This function disables all ahci_platform managed resources in the 273 * following order: 274 * 1) Phys 275 * 2) Resets 276 * 3) Clocks (through ahci_platform_disable_clks) 277 * 4) Regulator 278 */ 279 void ahci_platform_disable_resources(struct ahci_host_priv *hpriv) 280 { 281 ahci_platform_disable_phys(hpriv); 282 283 reset_control_assert(hpriv->rsts); 284 285 ahci_platform_disable_clks(hpriv); 286 287 ahci_platform_disable_regulators(hpriv); 288 } 289 EXPORT_SYMBOL_GPL(ahci_platform_disable_resources); 290 291 static void ahci_platform_put_resources(struct device *dev, void *res) 292 { 293 struct ahci_host_priv *hpriv = res; 294 int c; 295 296 if (hpriv->got_runtime_pm) { 297 pm_runtime_put_sync(dev); 298 pm_runtime_disable(dev); 299 } 300 301 for (c = 0; c < AHCI_MAX_CLKS && hpriv->clks[c]; c++) 302 clk_put(hpriv->clks[c]); 303 /* 304 * The regulators are tied to child node device and not to the 305 * SATA device itself. So we can't use devm for automatically 306 * releasing them. We have to do it manually here. 307 */ 308 for (c = 0; c < hpriv->nports; c++) 309 if (hpriv->target_pwrs && hpriv->target_pwrs[c]) 310 regulator_put(hpriv->target_pwrs[c]); 311 312 kfree(hpriv->target_pwrs); 313 } 314 315 static int ahci_platform_get_phy(struct ahci_host_priv *hpriv, u32 port, 316 struct device *dev, struct device_node *node) 317 { 318 int rc; 319 320 hpriv->phys[port] = devm_of_phy_get(dev, node, NULL); 321 322 if (!IS_ERR(hpriv->phys[port])) 323 return 0; 324 325 rc = PTR_ERR(hpriv->phys[port]); 326 switch (rc) { 327 case -ENOSYS: 328 /* No PHY support. Check if PHY is required. */ 329 if (of_find_property(node, "phys", NULL)) { 330 dev_err(dev, 331 "couldn't get PHY in node %pOFn: ENOSYS\n", 332 node); 333 break; 334 } 335 /* fall through */ 336 case -ENODEV: 337 /* continue normally */ 338 hpriv->phys[port] = NULL; 339 rc = 0; 340 break; 341 342 default: 343 dev_err(dev, 344 "couldn't get PHY in node %pOFn: %d\n", 345 node, rc); 346 347 break; 348 } 349 350 return rc; 351 } 352 353 static int ahci_platform_get_regulator(struct ahci_host_priv *hpriv, u32 port, 354 struct device *dev) 355 { 356 struct regulator *target_pwr; 357 int rc = 0; 358 359 target_pwr = regulator_get_optional(dev, "target"); 360 361 if (!IS_ERR(target_pwr)) 362 hpriv->target_pwrs[port] = target_pwr; 363 else 364 rc = PTR_ERR(target_pwr); 365 366 return rc; 367 } 368 369 /** 370 * ahci_platform_get_resources - Get platform resources 371 * @pdev: platform device to get resources for 372 * @flags: bitmap representing the resource to get 373 * 374 * This function allocates an ahci_host_priv struct, and gets the following 375 * resources, storing a reference to them inside the returned struct: 376 * 377 * 1) mmio registers (IORESOURCE_MEM 0, mandatory) 378 * 2) regulator for controlling the targets power (optional) 379 * regulator for controlling the AHCI controller (optional) 380 * 3) 0 - AHCI_MAX_CLKS clocks, as specified in the devs devicetree node, 381 * or for non devicetree enabled platforms a single clock 382 * 4) resets, if flags has AHCI_PLATFORM_GET_RESETS (optional) 383 * 5) phys (optional) 384 * 385 * RETURNS: 386 * The allocated ahci_host_priv on success, otherwise an ERR_PTR value 387 */ 388 struct ahci_host_priv *ahci_platform_get_resources(struct platform_device *pdev, 389 unsigned int flags) 390 { 391 struct device *dev = &pdev->dev; 392 struct ahci_host_priv *hpriv; 393 struct clk *clk; 394 struct device_node *child; 395 int i, enabled_ports = 0, rc = -ENOMEM, child_nodes; 396 u32 mask_port_map = 0; 397 398 if (!devres_open_group(dev, NULL, GFP_KERNEL)) 399 return ERR_PTR(-ENOMEM); 400 401 hpriv = devres_alloc(ahci_platform_put_resources, sizeof(*hpriv), 402 GFP_KERNEL); 403 if (!hpriv) 404 goto err_out; 405 406 devres_add(dev, hpriv); 407 408 hpriv->mmio = devm_ioremap_resource(dev, 409 platform_get_resource(pdev, IORESOURCE_MEM, 0)); 410 if (IS_ERR(hpriv->mmio)) { 411 rc = PTR_ERR(hpriv->mmio); 412 goto err_out; 413 } 414 415 for (i = 0; i < AHCI_MAX_CLKS; i++) { 416 /* 417 * For now we must use clk_get(dev, NULL) for the first clock, 418 * because some platforms (da850, spear13xx) are not yet 419 * converted to use devicetree for clocks. For new platforms 420 * this is equivalent to of_clk_get(dev->of_node, 0). 421 */ 422 if (i == 0) 423 clk = clk_get(dev, NULL); 424 else 425 clk = of_clk_get(dev->of_node, i); 426 427 if (IS_ERR(clk)) { 428 rc = PTR_ERR(clk); 429 if (rc == -EPROBE_DEFER) 430 goto err_out; 431 break; 432 } 433 hpriv->clks[i] = clk; 434 } 435 436 hpriv->ahci_regulator = devm_regulator_get_optional(dev, "ahci"); 437 if (IS_ERR(hpriv->ahci_regulator)) { 438 rc = PTR_ERR(hpriv->ahci_regulator); 439 if (rc == -EPROBE_DEFER) 440 goto err_out; 441 rc = 0; 442 hpriv->ahci_regulator = NULL; 443 } 444 445 hpriv->phy_regulator = devm_regulator_get_optional(dev, "phy"); 446 if (IS_ERR(hpriv->phy_regulator)) { 447 rc = PTR_ERR(hpriv->phy_regulator); 448 if (rc == -EPROBE_DEFER) 449 goto err_out; 450 rc = 0; 451 hpriv->phy_regulator = NULL; 452 } 453 454 if (flags & AHCI_PLATFORM_GET_RESETS) { 455 hpriv->rsts = devm_reset_control_array_get_optional_shared(dev); 456 if (IS_ERR(hpriv->rsts)) { 457 rc = PTR_ERR(hpriv->rsts); 458 goto err_out; 459 } 460 } 461 462 hpriv->nports = child_nodes = of_get_child_count(dev->of_node); 463 464 /* 465 * If no sub-node was found, we still need to set nports to 466 * one in order to be able to use the 467 * ahci_platform_[en|dis]able_[phys|regulators] functions. 468 */ 469 if (!child_nodes) 470 hpriv->nports = 1; 471 472 hpriv->phys = devm_kcalloc(dev, hpriv->nports, sizeof(*hpriv->phys), GFP_KERNEL); 473 if (!hpriv->phys) { 474 rc = -ENOMEM; 475 goto err_out; 476 } 477 /* 478 * We cannot use devm_ here, since ahci_platform_put_resources() uses 479 * target_pwrs after devm_ have freed memory 480 */ 481 hpriv->target_pwrs = kcalloc(hpriv->nports, sizeof(*hpriv->target_pwrs), GFP_KERNEL); 482 if (!hpriv->target_pwrs) { 483 rc = -ENOMEM; 484 goto err_out; 485 } 486 487 if (child_nodes) { 488 for_each_child_of_node(dev->of_node, child) { 489 u32 port; 490 struct platform_device *port_dev __maybe_unused; 491 492 if (!of_device_is_available(child)) 493 continue; 494 495 if (of_property_read_u32(child, "reg", &port)) { 496 rc = -EINVAL; 497 goto err_out; 498 } 499 500 if (port >= hpriv->nports) { 501 dev_warn(dev, "invalid port number %d\n", port); 502 continue; 503 } 504 mask_port_map |= BIT(port); 505 506 #ifdef CONFIG_OF_ADDRESS 507 of_platform_device_create(child, NULL, NULL); 508 509 port_dev = of_find_device_by_node(child); 510 511 if (port_dev) { 512 rc = ahci_platform_get_regulator(hpriv, port, 513 &port_dev->dev); 514 if (rc == -EPROBE_DEFER) 515 goto err_out; 516 } 517 #endif 518 519 rc = ahci_platform_get_phy(hpriv, port, dev, child); 520 if (rc) 521 goto err_out; 522 523 enabled_ports++; 524 } 525 if (!enabled_ports) { 526 dev_warn(dev, "No port enabled\n"); 527 rc = -ENODEV; 528 goto err_out; 529 } 530 531 if (!hpriv->mask_port_map) 532 hpriv->mask_port_map = mask_port_map; 533 } else { 534 /* 535 * If no sub-node was found, keep this for device tree 536 * compatibility 537 */ 538 rc = ahci_platform_get_phy(hpriv, 0, dev, dev->of_node); 539 if (rc) 540 goto err_out; 541 542 rc = ahci_platform_get_regulator(hpriv, 0, dev); 543 if (rc == -EPROBE_DEFER) 544 goto err_out; 545 } 546 pm_runtime_enable(dev); 547 pm_runtime_get_sync(dev); 548 hpriv->got_runtime_pm = true; 549 550 devres_remove_group(dev, NULL); 551 return hpriv; 552 553 err_out: 554 devres_release_group(dev, NULL); 555 return ERR_PTR(rc); 556 } 557 EXPORT_SYMBOL_GPL(ahci_platform_get_resources); 558 559 /** 560 * ahci_platform_init_host - Bring up an ahci-platform host 561 * @pdev: platform device pointer for the host 562 * @hpriv: ahci-host private data for the host 563 * @pi_template: template for the ata_port_info to use 564 * @sht: scsi_host_template to use when registering 565 * 566 * This function does all the usual steps needed to bring up an 567 * ahci-platform host, note any necessary resources (ie clks, phys, etc.) 568 * must be initialized / enabled before calling this. 569 * 570 * RETURNS: 571 * 0 on success otherwise a negative error code 572 */ 573 int ahci_platform_init_host(struct platform_device *pdev, 574 struct ahci_host_priv *hpriv, 575 const struct ata_port_info *pi_template, 576 struct scsi_host_template *sht) 577 { 578 struct device *dev = &pdev->dev; 579 struct ata_port_info pi = *pi_template; 580 const struct ata_port_info *ppi[] = { &pi, NULL }; 581 struct ata_host *host; 582 int i, irq, n_ports, rc; 583 584 irq = platform_get_irq(pdev, 0); 585 if (irq <= 0) { 586 if (irq != -EPROBE_DEFER) 587 dev_err(dev, "no irq\n"); 588 return irq; 589 } 590 591 hpriv->irq = irq; 592 593 /* prepare host */ 594 pi.private_data = (void *)(unsigned long)hpriv->flags; 595 596 ahci_save_initial_config(dev, hpriv); 597 598 if (hpriv->cap & HOST_CAP_NCQ) 599 pi.flags |= ATA_FLAG_NCQ; 600 601 if (hpriv->cap & HOST_CAP_PMP) 602 pi.flags |= ATA_FLAG_PMP; 603 604 ahci_set_em_messages(hpriv, &pi); 605 606 /* CAP.NP sometimes indicate the index of the last enabled 607 * port, at other times, that of the last possible port, so 608 * determining the maximum port number requires looking at 609 * both CAP.NP and port_map. 610 */ 611 n_ports = max(ahci_nr_ports(hpriv->cap), fls(hpriv->port_map)); 612 613 host = ata_host_alloc_pinfo(dev, ppi, n_ports); 614 if (!host) 615 return -ENOMEM; 616 617 host->private_data = hpriv; 618 619 if (!(hpriv->cap & HOST_CAP_SSS) || ahci_ignore_sss) 620 host->flags |= ATA_HOST_PARALLEL_SCAN; 621 else 622 dev_info(dev, "SSS flag set, parallel bus scan disabled\n"); 623 624 if (pi.flags & ATA_FLAG_EM) 625 ahci_reset_em(host); 626 627 for (i = 0; i < host->n_ports; i++) { 628 struct ata_port *ap = host->ports[i]; 629 630 ata_port_desc(ap, "mmio %pR", 631 platform_get_resource(pdev, IORESOURCE_MEM, 0)); 632 ata_port_desc(ap, "port 0x%x", 0x100 + ap->port_no * 0x80); 633 634 /* set enclosure management message type */ 635 if (ap->flags & ATA_FLAG_EM) 636 ap->em_message_type = hpriv->em_msg_type; 637 638 /* disabled/not-implemented port */ 639 if (!(hpriv->port_map & (1 << i))) 640 ap->ops = &ata_dummy_port_ops; 641 } 642 643 if (hpriv->cap & HOST_CAP_64) { 644 rc = dma_coerce_mask_and_coherent(dev, DMA_BIT_MASK(64)); 645 if (rc) { 646 rc = dma_coerce_mask_and_coherent(dev, 647 DMA_BIT_MASK(32)); 648 if (rc) { 649 dev_err(dev, "Failed to enable 64-bit DMA.\n"); 650 return rc; 651 } 652 dev_warn(dev, "Enable 32-bit DMA instead of 64-bit.\n"); 653 } 654 } 655 656 rc = ahci_reset_controller(host); 657 if (rc) 658 return rc; 659 660 ahci_init_controller(host); 661 ahci_print_info(host, "platform"); 662 663 return ahci_host_activate(host, sht); 664 } 665 EXPORT_SYMBOL_GPL(ahci_platform_init_host); 666 667 static void ahci_host_stop(struct ata_host *host) 668 { 669 struct ahci_host_priv *hpriv = host->private_data; 670 671 ahci_platform_disable_resources(hpriv); 672 } 673 674 /** 675 * ahci_platform_shutdown - Disable interrupts and stop DMA for host ports 676 * @pdev: platform device pointer for the host 677 * 678 * This function is called during system shutdown and performs the minimal 679 * deconfiguration required to ensure that an ahci_platform host cannot 680 * corrupt or otherwise interfere with a new kernel being started with kexec. 681 */ 682 void ahci_platform_shutdown(struct platform_device *pdev) 683 { 684 struct ata_host *host = platform_get_drvdata(pdev); 685 struct ahci_host_priv *hpriv = host->private_data; 686 void __iomem *mmio = hpriv->mmio; 687 int i; 688 689 for (i = 0; i < host->n_ports; i++) { 690 struct ata_port *ap = host->ports[i]; 691 692 /* Disable port interrupts */ 693 if (ap->ops->freeze) 694 ap->ops->freeze(ap); 695 696 /* Stop the port DMA engines */ 697 if (ap->ops->port_stop) 698 ap->ops->port_stop(ap); 699 } 700 701 /* Disable and clear host interrupts */ 702 writel(readl(mmio + HOST_CTL) & ~HOST_IRQ_EN, mmio + HOST_CTL); 703 readl(mmio + HOST_CTL); /* flush */ 704 writel(GENMASK(host->n_ports, 0), mmio + HOST_IRQ_STAT); 705 } 706 EXPORT_SYMBOL_GPL(ahci_platform_shutdown); 707 708 #ifdef CONFIG_PM_SLEEP 709 /** 710 * ahci_platform_suspend_host - Suspend an ahci-platform host 711 * @dev: device pointer for the host 712 * 713 * This function does all the usual steps needed to suspend an 714 * ahci-platform host, note any necessary resources (ie clks, phys, etc.) 715 * must be disabled after calling this. 716 * 717 * RETURNS: 718 * 0 on success otherwise a negative error code 719 */ 720 int ahci_platform_suspend_host(struct device *dev) 721 { 722 struct ata_host *host = dev_get_drvdata(dev); 723 struct ahci_host_priv *hpriv = host->private_data; 724 void __iomem *mmio = hpriv->mmio; 725 u32 ctl; 726 727 if (hpriv->flags & AHCI_HFLAG_NO_SUSPEND) { 728 dev_err(dev, "firmware update required for suspend/resume\n"); 729 return -EIO; 730 } 731 732 /* 733 * AHCI spec rev1.1 section 8.3.3: 734 * Software must disable interrupts prior to requesting a 735 * transition of the HBA to D3 state. 736 */ 737 ctl = readl(mmio + HOST_CTL); 738 ctl &= ~HOST_IRQ_EN; 739 writel(ctl, mmio + HOST_CTL); 740 readl(mmio + HOST_CTL); /* flush */ 741 742 if (hpriv->flags & AHCI_HFLAG_SUSPEND_PHYS) 743 ahci_platform_disable_phys(hpriv); 744 745 return ata_host_suspend(host, PMSG_SUSPEND); 746 } 747 EXPORT_SYMBOL_GPL(ahci_platform_suspend_host); 748 749 /** 750 * ahci_platform_resume_host - Resume an ahci-platform host 751 * @dev: device pointer for the host 752 * 753 * This function does all the usual steps needed to resume an ahci-platform 754 * host, note any necessary resources (ie clks, phys, etc.) must be 755 * initialized / enabled before calling this. 756 * 757 * RETURNS: 758 * 0 on success otherwise a negative error code 759 */ 760 int ahci_platform_resume_host(struct device *dev) 761 { 762 struct ata_host *host = dev_get_drvdata(dev); 763 struct ahci_host_priv *hpriv = host->private_data; 764 int rc; 765 766 if (dev->power.power_state.event == PM_EVENT_SUSPEND) { 767 rc = ahci_reset_controller(host); 768 if (rc) 769 return rc; 770 771 ahci_init_controller(host); 772 } 773 774 if (hpriv->flags & AHCI_HFLAG_SUSPEND_PHYS) 775 ahci_platform_enable_phys(hpriv); 776 777 ata_host_resume(host); 778 779 return 0; 780 } 781 EXPORT_SYMBOL_GPL(ahci_platform_resume_host); 782 783 /** 784 * ahci_platform_suspend - Suspend an ahci-platform device 785 * @dev: the platform device to suspend 786 * 787 * This function suspends the host associated with the device, followed by 788 * disabling all the resources of the device. 789 * 790 * RETURNS: 791 * 0 on success otherwise a negative error code 792 */ 793 int ahci_platform_suspend(struct device *dev) 794 { 795 struct ata_host *host = dev_get_drvdata(dev); 796 struct ahci_host_priv *hpriv = host->private_data; 797 int rc; 798 799 rc = ahci_platform_suspend_host(dev); 800 if (rc) 801 return rc; 802 803 ahci_platform_disable_resources(hpriv); 804 805 return 0; 806 } 807 EXPORT_SYMBOL_GPL(ahci_platform_suspend); 808 809 /** 810 * ahci_platform_resume - Resume an ahci-platform device 811 * @dev: the platform device to resume 812 * 813 * This function enables all the resources of the device followed by 814 * resuming the host associated with the device. 815 * 816 * RETURNS: 817 * 0 on success otherwise a negative error code 818 */ 819 int ahci_platform_resume(struct device *dev) 820 { 821 struct ata_host *host = dev_get_drvdata(dev); 822 struct ahci_host_priv *hpriv = host->private_data; 823 int rc; 824 825 rc = ahci_platform_enable_resources(hpriv); 826 if (rc) 827 return rc; 828 829 rc = ahci_platform_resume_host(dev); 830 if (rc) 831 goto disable_resources; 832 833 /* We resumed so update PM runtime state */ 834 pm_runtime_disable(dev); 835 pm_runtime_set_active(dev); 836 pm_runtime_enable(dev); 837 838 return 0; 839 840 disable_resources: 841 ahci_platform_disable_resources(hpriv); 842 843 return rc; 844 } 845 EXPORT_SYMBOL_GPL(ahci_platform_resume); 846 #endif 847 848 MODULE_DESCRIPTION("AHCI SATA platform library"); 849 MODULE_AUTHOR("Anton Vorontsov <avorontsov@ru.mvista.com>"); 850 MODULE_LICENSE("GPL"); 851