1 // SPDX-License-Identifier: GPL-2.0 2 /* 3 * drivers/base/power/runtime.c - Helper functions for device runtime PM 4 * 5 * Copyright (c) 2009 Rafael J. Wysocki <rjw@sisk.pl>, Novell Inc. 6 * Copyright (C) 2010 Alan Stern <stern@rowland.harvard.edu> 7 */ 8 #include <linux/sched/mm.h> 9 #include <linux/ktime.h> 10 #include <linux/hrtimer.h> 11 #include <linux/export.h> 12 #include <linux/pm_runtime.h> 13 #include <linux/pm_wakeirq.h> 14 #include <trace/events/rpm.h> 15 16 #include "../base.h" 17 #include "power.h" 18 19 typedef int (*pm_callback_t)(struct device *); 20 21 static pm_callback_t __rpm_get_callback(struct device *dev, size_t cb_offset) 22 { 23 pm_callback_t cb; 24 const struct dev_pm_ops *ops; 25 26 if (dev->pm_domain) 27 ops = &dev->pm_domain->ops; 28 else if (dev->type && dev->type->pm) 29 ops = dev->type->pm; 30 else if (dev->class && dev->class->pm) 31 ops = dev->class->pm; 32 else if (dev->bus && dev->bus->pm) 33 ops = dev->bus->pm; 34 else 35 ops = NULL; 36 37 if (ops) 38 cb = *(pm_callback_t *)((void *)ops + cb_offset); 39 else 40 cb = NULL; 41 42 if (!cb && dev->driver && dev->driver->pm) 43 cb = *(pm_callback_t *)((void *)dev->driver->pm + cb_offset); 44 45 return cb; 46 } 47 48 #define RPM_GET_CALLBACK(dev, callback) \ 49 __rpm_get_callback(dev, offsetof(struct dev_pm_ops, callback)) 50 51 static int rpm_resume(struct device *dev, int rpmflags); 52 static int rpm_suspend(struct device *dev, int rpmflags); 53 54 /** 55 * update_pm_runtime_accounting - Update the time accounting of power states 56 * @dev: Device to update the accounting for 57 * 58 * In order to be able to have time accounting of the various power states 59 * (as used by programs such as PowerTOP to show the effectiveness of runtime 60 * PM), we need to track the time spent in each state. 61 * update_pm_runtime_accounting must be called each time before the 62 * runtime_status field is updated, to account the time in the old state 63 * correctly. 64 */ 65 static void update_pm_runtime_accounting(struct device *dev) 66 { 67 u64 now, last, delta; 68 69 if (dev->power.disable_depth > 0) 70 return; 71 72 last = dev->power.accounting_timestamp; 73 74 now = ktime_get_mono_fast_ns(); 75 dev->power.accounting_timestamp = now; 76 77 /* 78 * Because ktime_get_mono_fast_ns() is not monotonic during 79 * timekeeping updates, ensure that 'now' is after the last saved 80 * timesptamp. 81 */ 82 if (now < last) 83 return; 84 85 delta = now - last; 86 87 if (dev->power.runtime_status == RPM_SUSPENDED) 88 dev->power.suspended_time += delta; 89 else 90 dev->power.active_time += delta; 91 } 92 93 static void __update_runtime_status(struct device *dev, enum rpm_status status) 94 { 95 update_pm_runtime_accounting(dev); 96 dev->power.runtime_status = status; 97 } 98 99 static u64 rpm_get_accounted_time(struct device *dev, bool suspended) 100 { 101 u64 time; 102 unsigned long flags; 103 104 spin_lock_irqsave(&dev->power.lock, flags); 105 106 update_pm_runtime_accounting(dev); 107 time = suspended ? dev->power.suspended_time : dev->power.active_time; 108 109 spin_unlock_irqrestore(&dev->power.lock, flags); 110 111 return time; 112 } 113 114 u64 pm_runtime_active_time(struct device *dev) 115 { 116 return rpm_get_accounted_time(dev, false); 117 } 118 119 u64 pm_runtime_suspended_time(struct device *dev) 120 { 121 return rpm_get_accounted_time(dev, true); 122 } 123 EXPORT_SYMBOL_GPL(pm_runtime_suspended_time); 124 125 /** 126 * pm_runtime_deactivate_timer - Deactivate given device's suspend timer. 127 * @dev: Device to handle. 128 */ 129 static void pm_runtime_deactivate_timer(struct device *dev) 130 { 131 if (dev->power.timer_expires > 0) { 132 hrtimer_try_to_cancel(&dev->power.suspend_timer); 133 dev->power.timer_expires = 0; 134 } 135 } 136 137 /** 138 * pm_runtime_cancel_pending - Deactivate suspend timer and cancel requests. 139 * @dev: Device to handle. 140 */ 141 static void pm_runtime_cancel_pending(struct device *dev) 142 { 143 pm_runtime_deactivate_timer(dev); 144 /* 145 * In case there's a request pending, make sure its work function will 146 * return without doing anything. 147 */ 148 dev->power.request = RPM_REQ_NONE; 149 } 150 151 /* 152 * pm_runtime_autosuspend_expiration - Get a device's autosuspend-delay expiration time. 153 * @dev: Device to handle. 154 * 155 * Compute the autosuspend-delay expiration time based on the device's 156 * power.last_busy time. If the delay has already expired or is disabled 157 * (negative) or the power.use_autosuspend flag isn't set, return 0. 158 * Otherwise return the expiration time in nanoseconds (adjusted to be nonzero). 159 * 160 * This function may be called either with or without dev->power.lock held. 161 * Either way it can be racy, since power.last_busy may be updated at any time. 162 */ 163 u64 pm_runtime_autosuspend_expiration(struct device *dev) 164 { 165 int autosuspend_delay; 166 u64 expires; 167 168 if (!dev->power.use_autosuspend) 169 return 0; 170 171 autosuspend_delay = READ_ONCE(dev->power.autosuspend_delay); 172 if (autosuspend_delay < 0) 173 return 0; 174 175 expires = READ_ONCE(dev->power.last_busy); 176 expires += (u64)autosuspend_delay * NSEC_PER_MSEC; 177 if (expires > ktime_get_mono_fast_ns()) 178 return expires; /* Expires in the future */ 179 180 return 0; 181 } 182 EXPORT_SYMBOL_GPL(pm_runtime_autosuspend_expiration); 183 184 static int dev_memalloc_noio(struct device *dev, void *data) 185 { 186 return dev->power.memalloc_noio; 187 } 188 189 /* 190 * pm_runtime_set_memalloc_noio - Set a device's memalloc_noio flag. 191 * @dev: Device to handle. 192 * @enable: True for setting the flag and False for clearing the flag. 193 * 194 * Set the flag for all devices in the path from the device to the 195 * root device in the device tree if @enable is true, otherwise clear 196 * the flag for devices in the path whose siblings don't set the flag. 197 * 198 * The function should only be called by block device, or network 199 * device driver for solving the deadlock problem during runtime 200 * resume/suspend: 201 * 202 * If memory allocation with GFP_KERNEL is called inside runtime 203 * resume/suspend callback of any one of its ancestors(or the 204 * block device itself), the deadlock may be triggered inside the 205 * memory allocation since it might not complete until the block 206 * device becomes active and the involed page I/O finishes. The 207 * situation is pointed out first by Alan Stern. Network device 208 * are involved in iSCSI kind of situation. 209 * 210 * The lock of dev_hotplug_mutex is held in the function for handling 211 * hotplug race because pm_runtime_set_memalloc_noio() may be called 212 * in async probe(). 213 * 214 * The function should be called between device_add() and device_del() 215 * on the affected device(block/network device). 216 */ 217 void pm_runtime_set_memalloc_noio(struct device *dev, bool enable) 218 { 219 static DEFINE_MUTEX(dev_hotplug_mutex); 220 221 mutex_lock(&dev_hotplug_mutex); 222 for (;;) { 223 bool enabled; 224 225 /* hold power lock since bitfield is not SMP-safe. */ 226 spin_lock_irq(&dev->power.lock); 227 enabled = dev->power.memalloc_noio; 228 dev->power.memalloc_noio = enable; 229 spin_unlock_irq(&dev->power.lock); 230 231 /* 232 * not need to enable ancestors any more if the device 233 * has been enabled. 234 */ 235 if (enabled && enable) 236 break; 237 238 dev = dev->parent; 239 240 /* 241 * clear flag of the parent device only if all the 242 * children don't set the flag because ancestor's 243 * flag was set by any one of the descendants. 244 */ 245 if (!dev || (!enable && 246 device_for_each_child(dev, NULL, 247 dev_memalloc_noio))) 248 break; 249 } 250 mutex_unlock(&dev_hotplug_mutex); 251 } 252 EXPORT_SYMBOL_GPL(pm_runtime_set_memalloc_noio); 253 254 /** 255 * rpm_check_suspend_allowed - Test whether a device may be suspended. 256 * @dev: Device to test. 257 */ 258 static int rpm_check_suspend_allowed(struct device *dev) 259 { 260 int retval = 0; 261 262 if (dev->power.runtime_error) 263 retval = -EINVAL; 264 else if (dev->power.disable_depth > 0) 265 retval = -EACCES; 266 else if (atomic_read(&dev->power.usage_count) > 0) 267 retval = -EAGAIN; 268 else if (!dev->power.ignore_children && 269 atomic_read(&dev->power.child_count)) 270 retval = -EBUSY; 271 272 /* Pending resume requests take precedence over suspends. */ 273 else if ((dev->power.deferred_resume 274 && dev->power.runtime_status == RPM_SUSPENDING) 275 || (dev->power.request_pending 276 && dev->power.request == RPM_REQ_RESUME)) 277 retval = -EAGAIN; 278 else if (__dev_pm_qos_resume_latency(dev) == 0) 279 retval = -EPERM; 280 else if (dev->power.runtime_status == RPM_SUSPENDED) 281 retval = 1; 282 283 return retval; 284 } 285 286 static int rpm_get_suppliers(struct device *dev) 287 { 288 struct device_link *link; 289 290 list_for_each_entry_rcu(link, &dev->links.suppliers, c_node, 291 device_links_read_lock_held()) { 292 int retval; 293 294 if (!(link->flags & DL_FLAG_PM_RUNTIME)) 295 continue; 296 297 retval = pm_runtime_get_sync(link->supplier); 298 /* Ignore suppliers with disabled runtime PM. */ 299 if (retval < 0 && retval != -EACCES) { 300 pm_runtime_put_noidle(link->supplier); 301 return retval; 302 } 303 refcount_inc(&link->rpm_active); 304 } 305 return 0; 306 } 307 308 static void __rpm_put_suppliers(struct device *dev, bool try_to_suspend) 309 { 310 struct device_link *link; 311 312 list_for_each_entry_rcu(link, &dev->links.suppliers, c_node, 313 device_links_read_lock_held()) { 314 315 while (refcount_dec_not_one(&link->rpm_active)) 316 pm_runtime_put_noidle(link->supplier); 317 318 if (try_to_suspend) 319 pm_request_idle(link->supplier); 320 } 321 } 322 323 static void rpm_put_suppliers(struct device *dev) 324 { 325 __rpm_put_suppliers(dev, true); 326 } 327 328 static void rpm_suspend_suppliers(struct device *dev) 329 { 330 struct device_link *link; 331 int idx = device_links_read_lock(); 332 333 list_for_each_entry_rcu(link, &dev->links.suppliers, c_node, 334 device_links_read_lock_held()) 335 pm_request_idle(link->supplier); 336 337 device_links_read_unlock(idx); 338 } 339 340 /** 341 * __rpm_callback - Run a given runtime PM callback for a given device. 342 * @cb: Runtime PM callback to run. 343 * @dev: Device to run the callback for. 344 */ 345 static int __rpm_callback(int (*cb)(struct device *), struct device *dev) 346 __releases(&dev->power.lock) __acquires(&dev->power.lock) 347 { 348 int retval, idx; 349 bool use_links = dev->power.links_count > 0; 350 351 if (dev->power.irq_safe) { 352 spin_unlock(&dev->power.lock); 353 } else { 354 spin_unlock_irq(&dev->power.lock); 355 356 /* 357 * Resume suppliers if necessary. 358 * 359 * The device's runtime PM status cannot change until this 360 * routine returns, so it is safe to read the status outside of 361 * the lock. 362 */ 363 if (use_links && dev->power.runtime_status == RPM_RESUMING) { 364 idx = device_links_read_lock(); 365 366 retval = rpm_get_suppliers(dev); 367 if (retval) { 368 rpm_put_suppliers(dev); 369 goto fail; 370 } 371 372 device_links_read_unlock(idx); 373 } 374 } 375 376 retval = cb(dev); 377 378 if (dev->power.irq_safe) { 379 spin_lock(&dev->power.lock); 380 } else { 381 /* 382 * If the device is suspending and the callback has returned 383 * success, drop the usage counters of the suppliers that have 384 * been reference counted on its resume. 385 * 386 * Do that if resume fails too. 387 */ 388 if (use_links 389 && ((dev->power.runtime_status == RPM_SUSPENDING && !retval) 390 || (dev->power.runtime_status == RPM_RESUMING && retval))) { 391 idx = device_links_read_lock(); 392 393 __rpm_put_suppliers(dev, false); 394 395 fail: 396 device_links_read_unlock(idx); 397 } 398 399 spin_lock_irq(&dev->power.lock); 400 } 401 402 return retval; 403 } 404 405 /** 406 * rpm_idle - Notify device bus type if the device can be suspended. 407 * @dev: Device to notify the bus type about. 408 * @rpmflags: Flag bits. 409 * 410 * Check if the device's runtime PM status allows it to be suspended. If 411 * another idle notification has been started earlier, return immediately. If 412 * the RPM_ASYNC flag is set then queue an idle-notification request; otherwise 413 * run the ->runtime_idle() callback directly. If the ->runtime_idle callback 414 * doesn't exist or if it returns 0, call rpm_suspend with the RPM_AUTO flag. 415 * 416 * This function must be called under dev->power.lock with interrupts disabled. 417 */ 418 static int rpm_idle(struct device *dev, int rpmflags) 419 { 420 int (*callback)(struct device *); 421 int retval; 422 423 trace_rpm_idle_rcuidle(dev, rpmflags); 424 retval = rpm_check_suspend_allowed(dev); 425 if (retval < 0) 426 ; /* Conditions are wrong. */ 427 428 /* Idle notifications are allowed only in the RPM_ACTIVE state. */ 429 else if (dev->power.runtime_status != RPM_ACTIVE) 430 retval = -EAGAIN; 431 432 /* 433 * Any pending request other than an idle notification takes 434 * precedence over us, except that the timer may be running. 435 */ 436 else if (dev->power.request_pending && 437 dev->power.request > RPM_REQ_IDLE) 438 retval = -EAGAIN; 439 440 /* Act as though RPM_NOWAIT is always set. */ 441 else if (dev->power.idle_notification) 442 retval = -EINPROGRESS; 443 if (retval) 444 goto out; 445 446 /* Pending requests need to be canceled. */ 447 dev->power.request = RPM_REQ_NONE; 448 449 if (dev->power.no_callbacks) 450 goto out; 451 452 /* Carry out an asynchronous or a synchronous idle notification. */ 453 if (rpmflags & RPM_ASYNC) { 454 dev->power.request = RPM_REQ_IDLE; 455 if (!dev->power.request_pending) { 456 dev->power.request_pending = true; 457 queue_work(pm_wq, &dev->power.work); 458 } 459 trace_rpm_return_int_rcuidle(dev, _THIS_IP_, 0); 460 return 0; 461 } 462 463 dev->power.idle_notification = true; 464 465 callback = RPM_GET_CALLBACK(dev, runtime_idle); 466 467 if (callback) 468 retval = __rpm_callback(callback, dev); 469 470 dev->power.idle_notification = false; 471 wake_up_all(&dev->power.wait_queue); 472 473 out: 474 trace_rpm_return_int_rcuidle(dev, _THIS_IP_, retval); 475 return retval ? retval : rpm_suspend(dev, rpmflags | RPM_AUTO); 476 } 477 478 /** 479 * rpm_callback - Run a given runtime PM callback for a given device. 480 * @cb: Runtime PM callback to run. 481 * @dev: Device to run the callback for. 482 */ 483 static int rpm_callback(int (*cb)(struct device *), struct device *dev) 484 { 485 int retval; 486 487 if (!cb) 488 return -ENOSYS; 489 490 if (dev->power.memalloc_noio) { 491 unsigned int noio_flag; 492 493 /* 494 * Deadlock might be caused if memory allocation with 495 * GFP_KERNEL happens inside runtime_suspend and 496 * runtime_resume callbacks of one block device's 497 * ancestor or the block device itself. Network 498 * device might be thought as part of iSCSI block 499 * device, so network device and its ancestor should 500 * be marked as memalloc_noio too. 501 */ 502 noio_flag = memalloc_noio_save(); 503 retval = __rpm_callback(cb, dev); 504 memalloc_noio_restore(noio_flag); 505 } else { 506 retval = __rpm_callback(cb, dev); 507 } 508 509 dev->power.runtime_error = retval; 510 return retval != -EACCES ? retval : -EIO; 511 } 512 513 /** 514 * rpm_suspend - Carry out runtime suspend of given device. 515 * @dev: Device to suspend. 516 * @rpmflags: Flag bits. 517 * 518 * Check if the device's runtime PM status allows it to be suspended. 519 * Cancel a pending idle notification, autosuspend or suspend. If 520 * another suspend has been started earlier, either return immediately 521 * or wait for it to finish, depending on the RPM_NOWAIT and RPM_ASYNC 522 * flags. If the RPM_ASYNC flag is set then queue a suspend request; 523 * otherwise run the ->runtime_suspend() callback directly. When 524 * ->runtime_suspend succeeded, if a deferred resume was requested while 525 * the callback was running then carry it out, otherwise send an idle 526 * notification for its parent (if the suspend succeeded and both 527 * ignore_children of parent->power and irq_safe of dev->power are not set). 528 * If ->runtime_suspend failed with -EAGAIN or -EBUSY, and if the RPM_AUTO 529 * flag is set and the next autosuspend-delay expiration time is in the 530 * future, schedule another autosuspend attempt. 531 * 532 * This function must be called under dev->power.lock with interrupts disabled. 533 */ 534 static int rpm_suspend(struct device *dev, int rpmflags) 535 __releases(&dev->power.lock) __acquires(&dev->power.lock) 536 { 537 int (*callback)(struct device *); 538 struct device *parent = NULL; 539 int retval; 540 541 trace_rpm_suspend_rcuidle(dev, rpmflags); 542 543 repeat: 544 retval = rpm_check_suspend_allowed(dev); 545 if (retval < 0) 546 goto out; /* Conditions are wrong. */ 547 548 /* Synchronous suspends are not allowed in the RPM_RESUMING state. */ 549 if (dev->power.runtime_status == RPM_RESUMING && !(rpmflags & RPM_ASYNC)) 550 retval = -EAGAIN; 551 if (retval) 552 goto out; 553 554 /* If the autosuspend_delay time hasn't expired yet, reschedule. */ 555 if ((rpmflags & RPM_AUTO) 556 && dev->power.runtime_status != RPM_SUSPENDING) { 557 u64 expires = pm_runtime_autosuspend_expiration(dev); 558 559 if (expires != 0) { 560 /* Pending requests need to be canceled. */ 561 dev->power.request = RPM_REQ_NONE; 562 563 /* 564 * Optimization: If the timer is already running and is 565 * set to expire at or before the autosuspend delay, 566 * avoid the overhead of resetting it. Just let it 567 * expire; pm_suspend_timer_fn() will take care of the 568 * rest. 569 */ 570 if (!(dev->power.timer_expires && 571 dev->power.timer_expires <= expires)) { 572 /* 573 * We add a slack of 25% to gather wakeups 574 * without sacrificing the granularity. 575 */ 576 u64 slack = (u64)READ_ONCE(dev->power.autosuspend_delay) * 577 (NSEC_PER_MSEC >> 2); 578 579 dev->power.timer_expires = expires; 580 hrtimer_start_range_ns(&dev->power.suspend_timer, 581 ns_to_ktime(expires), 582 slack, 583 HRTIMER_MODE_ABS); 584 } 585 dev->power.timer_autosuspends = 1; 586 goto out; 587 } 588 } 589 590 /* Other scheduled or pending requests need to be canceled. */ 591 pm_runtime_cancel_pending(dev); 592 593 if (dev->power.runtime_status == RPM_SUSPENDING) { 594 DEFINE_WAIT(wait); 595 596 if (rpmflags & (RPM_ASYNC | RPM_NOWAIT)) { 597 retval = -EINPROGRESS; 598 goto out; 599 } 600 601 if (dev->power.irq_safe) { 602 spin_unlock(&dev->power.lock); 603 604 cpu_relax(); 605 606 spin_lock(&dev->power.lock); 607 goto repeat; 608 } 609 610 /* Wait for the other suspend running in parallel with us. */ 611 for (;;) { 612 prepare_to_wait(&dev->power.wait_queue, &wait, 613 TASK_UNINTERRUPTIBLE); 614 if (dev->power.runtime_status != RPM_SUSPENDING) 615 break; 616 617 spin_unlock_irq(&dev->power.lock); 618 619 schedule(); 620 621 spin_lock_irq(&dev->power.lock); 622 } 623 finish_wait(&dev->power.wait_queue, &wait); 624 goto repeat; 625 } 626 627 if (dev->power.no_callbacks) 628 goto no_callback; /* Assume success. */ 629 630 /* Carry out an asynchronous or a synchronous suspend. */ 631 if (rpmflags & RPM_ASYNC) { 632 dev->power.request = (rpmflags & RPM_AUTO) ? 633 RPM_REQ_AUTOSUSPEND : RPM_REQ_SUSPEND; 634 if (!dev->power.request_pending) { 635 dev->power.request_pending = true; 636 queue_work(pm_wq, &dev->power.work); 637 } 638 goto out; 639 } 640 641 __update_runtime_status(dev, RPM_SUSPENDING); 642 643 callback = RPM_GET_CALLBACK(dev, runtime_suspend); 644 645 dev_pm_enable_wake_irq_check(dev, true); 646 retval = rpm_callback(callback, dev); 647 if (retval) 648 goto fail; 649 650 no_callback: 651 __update_runtime_status(dev, RPM_SUSPENDED); 652 pm_runtime_deactivate_timer(dev); 653 654 if (dev->parent) { 655 parent = dev->parent; 656 atomic_add_unless(&parent->power.child_count, -1, 0); 657 } 658 wake_up_all(&dev->power.wait_queue); 659 660 if (dev->power.deferred_resume) { 661 dev->power.deferred_resume = false; 662 rpm_resume(dev, 0); 663 retval = -EAGAIN; 664 goto out; 665 } 666 667 if (dev->power.irq_safe) 668 goto out; 669 670 /* Maybe the parent is now able to suspend. */ 671 if (parent && !parent->power.ignore_children) { 672 spin_unlock(&dev->power.lock); 673 674 spin_lock(&parent->power.lock); 675 rpm_idle(parent, RPM_ASYNC); 676 spin_unlock(&parent->power.lock); 677 678 spin_lock(&dev->power.lock); 679 } 680 /* Maybe the suppliers are now able to suspend. */ 681 if (dev->power.links_count > 0) { 682 spin_unlock_irq(&dev->power.lock); 683 684 rpm_suspend_suppliers(dev); 685 686 spin_lock_irq(&dev->power.lock); 687 } 688 689 out: 690 trace_rpm_return_int_rcuidle(dev, _THIS_IP_, retval); 691 692 return retval; 693 694 fail: 695 dev_pm_disable_wake_irq_check(dev); 696 __update_runtime_status(dev, RPM_ACTIVE); 697 dev->power.deferred_resume = false; 698 wake_up_all(&dev->power.wait_queue); 699 700 if (retval == -EAGAIN || retval == -EBUSY) { 701 dev->power.runtime_error = 0; 702 703 /* 704 * If the callback routine failed an autosuspend, and 705 * if the last_busy time has been updated so that there 706 * is a new autosuspend expiration time, automatically 707 * reschedule another autosuspend. 708 */ 709 if ((rpmflags & RPM_AUTO) && 710 pm_runtime_autosuspend_expiration(dev) != 0) 711 goto repeat; 712 } else { 713 pm_runtime_cancel_pending(dev); 714 } 715 goto out; 716 } 717 718 /** 719 * rpm_resume - Carry out runtime resume of given device. 720 * @dev: Device to resume. 721 * @rpmflags: Flag bits. 722 * 723 * Check if the device's runtime PM status allows it to be resumed. Cancel 724 * any scheduled or pending requests. If another resume has been started 725 * earlier, either return immediately or wait for it to finish, depending on the 726 * RPM_NOWAIT and RPM_ASYNC flags. Similarly, if there's a suspend running in 727 * parallel with this function, either tell the other process to resume after 728 * suspending (deferred_resume) or wait for it to finish. If the RPM_ASYNC 729 * flag is set then queue a resume request; otherwise run the 730 * ->runtime_resume() callback directly. Queue an idle notification for the 731 * device if the resume succeeded. 732 * 733 * This function must be called under dev->power.lock with interrupts disabled. 734 */ 735 static int rpm_resume(struct device *dev, int rpmflags) 736 __releases(&dev->power.lock) __acquires(&dev->power.lock) 737 { 738 int (*callback)(struct device *); 739 struct device *parent = NULL; 740 int retval = 0; 741 742 trace_rpm_resume_rcuidle(dev, rpmflags); 743 744 repeat: 745 if (dev->power.runtime_error) 746 retval = -EINVAL; 747 else if (dev->power.disable_depth == 1 && dev->power.is_suspended 748 && dev->power.runtime_status == RPM_ACTIVE) 749 retval = 1; 750 else if (dev->power.disable_depth > 0) 751 retval = -EACCES; 752 if (retval) 753 goto out; 754 755 /* 756 * Other scheduled or pending requests need to be canceled. Small 757 * optimization: If an autosuspend timer is running, leave it running 758 * rather than cancelling it now only to restart it again in the near 759 * future. 760 */ 761 dev->power.request = RPM_REQ_NONE; 762 if (!dev->power.timer_autosuspends) 763 pm_runtime_deactivate_timer(dev); 764 765 if (dev->power.runtime_status == RPM_ACTIVE) { 766 retval = 1; 767 goto out; 768 } 769 770 if (dev->power.runtime_status == RPM_RESUMING 771 || dev->power.runtime_status == RPM_SUSPENDING) { 772 DEFINE_WAIT(wait); 773 774 if (rpmflags & (RPM_ASYNC | RPM_NOWAIT)) { 775 if (dev->power.runtime_status == RPM_SUSPENDING) 776 dev->power.deferred_resume = true; 777 else 778 retval = -EINPROGRESS; 779 goto out; 780 } 781 782 if (dev->power.irq_safe) { 783 spin_unlock(&dev->power.lock); 784 785 cpu_relax(); 786 787 spin_lock(&dev->power.lock); 788 goto repeat; 789 } 790 791 /* Wait for the operation carried out in parallel with us. */ 792 for (;;) { 793 prepare_to_wait(&dev->power.wait_queue, &wait, 794 TASK_UNINTERRUPTIBLE); 795 if (dev->power.runtime_status != RPM_RESUMING 796 && dev->power.runtime_status != RPM_SUSPENDING) 797 break; 798 799 spin_unlock_irq(&dev->power.lock); 800 801 schedule(); 802 803 spin_lock_irq(&dev->power.lock); 804 } 805 finish_wait(&dev->power.wait_queue, &wait); 806 goto repeat; 807 } 808 809 /* 810 * See if we can skip waking up the parent. This is safe only if 811 * power.no_callbacks is set, because otherwise we don't know whether 812 * the resume will actually succeed. 813 */ 814 if (dev->power.no_callbacks && !parent && dev->parent) { 815 spin_lock_nested(&dev->parent->power.lock, SINGLE_DEPTH_NESTING); 816 if (dev->parent->power.disable_depth > 0 817 || dev->parent->power.ignore_children 818 || dev->parent->power.runtime_status == RPM_ACTIVE) { 819 atomic_inc(&dev->parent->power.child_count); 820 spin_unlock(&dev->parent->power.lock); 821 retval = 1; 822 goto no_callback; /* Assume success. */ 823 } 824 spin_unlock(&dev->parent->power.lock); 825 } 826 827 /* Carry out an asynchronous or a synchronous resume. */ 828 if (rpmflags & RPM_ASYNC) { 829 dev->power.request = RPM_REQ_RESUME; 830 if (!dev->power.request_pending) { 831 dev->power.request_pending = true; 832 queue_work(pm_wq, &dev->power.work); 833 } 834 retval = 0; 835 goto out; 836 } 837 838 if (!parent && dev->parent) { 839 /* 840 * Increment the parent's usage counter and resume it if 841 * necessary. Not needed if dev is irq-safe; then the 842 * parent is permanently resumed. 843 */ 844 parent = dev->parent; 845 if (dev->power.irq_safe) 846 goto skip_parent; 847 spin_unlock(&dev->power.lock); 848 849 pm_runtime_get_noresume(parent); 850 851 spin_lock(&parent->power.lock); 852 /* 853 * Resume the parent if it has runtime PM enabled and not been 854 * set to ignore its children. 855 */ 856 if (!parent->power.disable_depth 857 && !parent->power.ignore_children) { 858 rpm_resume(parent, 0); 859 if (parent->power.runtime_status != RPM_ACTIVE) 860 retval = -EBUSY; 861 } 862 spin_unlock(&parent->power.lock); 863 864 spin_lock(&dev->power.lock); 865 if (retval) 866 goto out; 867 goto repeat; 868 } 869 skip_parent: 870 871 if (dev->power.no_callbacks) 872 goto no_callback; /* Assume success. */ 873 874 __update_runtime_status(dev, RPM_RESUMING); 875 876 callback = RPM_GET_CALLBACK(dev, runtime_resume); 877 878 dev_pm_disable_wake_irq_check(dev); 879 retval = rpm_callback(callback, dev); 880 if (retval) { 881 __update_runtime_status(dev, RPM_SUSPENDED); 882 pm_runtime_cancel_pending(dev); 883 dev_pm_enable_wake_irq_check(dev, false); 884 } else { 885 no_callback: 886 __update_runtime_status(dev, RPM_ACTIVE); 887 pm_runtime_mark_last_busy(dev); 888 if (parent) 889 atomic_inc(&parent->power.child_count); 890 } 891 wake_up_all(&dev->power.wait_queue); 892 893 if (retval >= 0) 894 rpm_idle(dev, RPM_ASYNC); 895 896 out: 897 if (parent && !dev->power.irq_safe) { 898 spin_unlock_irq(&dev->power.lock); 899 900 pm_runtime_put(parent); 901 902 spin_lock_irq(&dev->power.lock); 903 } 904 905 trace_rpm_return_int_rcuidle(dev, _THIS_IP_, retval); 906 907 return retval; 908 } 909 910 /** 911 * pm_runtime_work - Universal runtime PM work function. 912 * @work: Work structure used for scheduling the execution of this function. 913 * 914 * Use @work to get the device object the work is to be done for, determine what 915 * is to be done and execute the appropriate runtime PM function. 916 */ 917 static void pm_runtime_work(struct work_struct *work) 918 { 919 struct device *dev = container_of(work, struct device, power.work); 920 enum rpm_request req; 921 922 spin_lock_irq(&dev->power.lock); 923 924 if (!dev->power.request_pending) 925 goto out; 926 927 req = dev->power.request; 928 dev->power.request = RPM_REQ_NONE; 929 dev->power.request_pending = false; 930 931 switch (req) { 932 case RPM_REQ_NONE: 933 break; 934 case RPM_REQ_IDLE: 935 rpm_idle(dev, RPM_NOWAIT); 936 break; 937 case RPM_REQ_SUSPEND: 938 rpm_suspend(dev, RPM_NOWAIT); 939 break; 940 case RPM_REQ_AUTOSUSPEND: 941 rpm_suspend(dev, RPM_NOWAIT | RPM_AUTO); 942 break; 943 case RPM_REQ_RESUME: 944 rpm_resume(dev, RPM_NOWAIT); 945 break; 946 } 947 948 out: 949 spin_unlock_irq(&dev->power.lock); 950 } 951 952 /** 953 * pm_suspend_timer_fn - Timer function for pm_schedule_suspend(). 954 * @timer: hrtimer used by pm_schedule_suspend(). 955 * 956 * Check if the time is right and queue a suspend request. 957 */ 958 static enum hrtimer_restart pm_suspend_timer_fn(struct hrtimer *timer) 959 { 960 struct device *dev = container_of(timer, struct device, power.suspend_timer); 961 unsigned long flags; 962 u64 expires; 963 964 spin_lock_irqsave(&dev->power.lock, flags); 965 966 expires = dev->power.timer_expires; 967 /* 968 * If 'expires' is after the current time, we've been called 969 * too early. 970 */ 971 if (expires > 0 && expires < ktime_get_mono_fast_ns()) { 972 dev->power.timer_expires = 0; 973 rpm_suspend(dev, dev->power.timer_autosuspends ? 974 (RPM_ASYNC | RPM_AUTO) : RPM_ASYNC); 975 } 976 977 spin_unlock_irqrestore(&dev->power.lock, flags); 978 979 return HRTIMER_NORESTART; 980 } 981 982 /** 983 * pm_schedule_suspend - Set up a timer to submit a suspend request in future. 984 * @dev: Device to suspend. 985 * @delay: Time to wait before submitting a suspend request, in milliseconds. 986 */ 987 int pm_schedule_suspend(struct device *dev, unsigned int delay) 988 { 989 unsigned long flags; 990 u64 expires; 991 int retval; 992 993 spin_lock_irqsave(&dev->power.lock, flags); 994 995 if (!delay) { 996 retval = rpm_suspend(dev, RPM_ASYNC); 997 goto out; 998 } 999 1000 retval = rpm_check_suspend_allowed(dev); 1001 if (retval) 1002 goto out; 1003 1004 /* Other scheduled or pending requests need to be canceled. */ 1005 pm_runtime_cancel_pending(dev); 1006 1007 expires = ktime_get_mono_fast_ns() + (u64)delay * NSEC_PER_MSEC; 1008 dev->power.timer_expires = expires; 1009 dev->power.timer_autosuspends = 0; 1010 hrtimer_start(&dev->power.suspend_timer, expires, HRTIMER_MODE_ABS); 1011 1012 out: 1013 spin_unlock_irqrestore(&dev->power.lock, flags); 1014 1015 return retval; 1016 } 1017 EXPORT_SYMBOL_GPL(pm_schedule_suspend); 1018 1019 /** 1020 * __pm_runtime_idle - Entry point for runtime idle operations. 1021 * @dev: Device to send idle notification for. 1022 * @rpmflags: Flag bits. 1023 * 1024 * If the RPM_GET_PUT flag is set, decrement the device's usage count and 1025 * return immediately if it is larger than zero. Then carry out an idle 1026 * notification, either synchronous or asynchronous. 1027 * 1028 * This routine may be called in atomic context if the RPM_ASYNC flag is set, 1029 * or if pm_runtime_irq_safe() has been called. 1030 */ 1031 int __pm_runtime_idle(struct device *dev, int rpmflags) 1032 { 1033 unsigned long flags; 1034 int retval; 1035 1036 if (rpmflags & RPM_GET_PUT) { 1037 if (!atomic_dec_and_test(&dev->power.usage_count)) { 1038 trace_rpm_usage_rcuidle(dev, rpmflags); 1039 return 0; 1040 } 1041 } 1042 1043 might_sleep_if(!(rpmflags & RPM_ASYNC) && !dev->power.irq_safe); 1044 1045 spin_lock_irqsave(&dev->power.lock, flags); 1046 retval = rpm_idle(dev, rpmflags); 1047 spin_unlock_irqrestore(&dev->power.lock, flags); 1048 1049 return retval; 1050 } 1051 EXPORT_SYMBOL_GPL(__pm_runtime_idle); 1052 1053 /** 1054 * __pm_runtime_suspend - Entry point for runtime put/suspend operations. 1055 * @dev: Device to suspend. 1056 * @rpmflags: Flag bits. 1057 * 1058 * If the RPM_GET_PUT flag is set, decrement the device's usage count and 1059 * return immediately if it is larger than zero. Then carry out a suspend, 1060 * either synchronous or asynchronous. 1061 * 1062 * This routine may be called in atomic context if the RPM_ASYNC flag is set, 1063 * or if pm_runtime_irq_safe() has been called. 1064 */ 1065 int __pm_runtime_suspend(struct device *dev, int rpmflags) 1066 { 1067 unsigned long flags; 1068 int retval; 1069 1070 if (rpmflags & RPM_GET_PUT) { 1071 if (!atomic_dec_and_test(&dev->power.usage_count)) { 1072 trace_rpm_usage_rcuidle(dev, rpmflags); 1073 return 0; 1074 } 1075 } 1076 1077 might_sleep_if(!(rpmflags & RPM_ASYNC) && !dev->power.irq_safe); 1078 1079 spin_lock_irqsave(&dev->power.lock, flags); 1080 retval = rpm_suspend(dev, rpmflags); 1081 spin_unlock_irqrestore(&dev->power.lock, flags); 1082 1083 return retval; 1084 } 1085 EXPORT_SYMBOL_GPL(__pm_runtime_suspend); 1086 1087 /** 1088 * __pm_runtime_resume - Entry point for runtime resume operations. 1089 * @dev: Device to resume. 1090 * @rpmflags: Flag bits. 1091 * 1092 * If the RPM_GET_PUT flag is set, increment the device's usage count. Then 1093 * carry out a resume, either synchronous or asynchronous. 1094 * 1095 * This routine may be called in atomic context if the RPM_ASYNC flag is set, 1096 * or if pm_runtime_irq_safe() has been called. 1097 */ 1098 int __pm_runtime_resume(struct device *dev, int rpmflags) 1099 { 1100 unsigned long flags; 1101 int retval; 1102 1103 might_sleep_if(!(rpmflags & RPM_ASYNC) && !dev->power.irq_safe && 1104 dev->power.runtime_status != RPM_ACTIVE); 1105 1106 if (rpmflags & RPM_GET_PUT) 1107 atomic_inc(&dev->power.usage_count); 1108 1109 spin_lock_irqsave(&dev->power.lock, flags); 1110 retval = rpm_resume(dev, rpmflags); 1111 spin_unlock_irqrestore(&dev->power.lock, flags); 1112 1113 return retval; 1114 } 1115 EXPORT_SYMBOL_GPL(__pm_runtime_resume); 1116 1117 /** 1118 * pm_runtime_get_if_active - Conditionally bump up device usage counter. 1119 * @dev: Device to handle. 1120 * @ign_usage_count: Whether or not to look at the current usage counter value. 1121 * 1122 * Return -EINVAL if runtime PM is disabled for @dev. 1123 * 1124 * Otherwise, if the runtime PM status of @dev is %RPM_ACTIVE and either 1125 * @ign_usage_count is %true or the runtime PM usage counter of @dev is not 1126 * zero, increment the usage counter of @dev and return 1. Otherwise, return 0 1127 * without changing the usage counter. 1128 * 1129 * If @ign_usage_count is %true, this function can be used to prevent suspending 1130 * the device when its runtime PM status is %RPM_ACTIVE. 1131 * 1132 * If @ign_usage_count is %false, this function can be used to prevent 1133 * suspending the device when both its runtime PM status is %RPM_ACTIVE and its 1134 * runtime PM usage counter is not zero. 1135 * 1136 * The caller is responsible for decrementing the runtime PM usage counter of 1137 * @dev after this function has returned a positive value for it. 1138 */ 1139 int pm_runtime_get_if_active(struct device *dev, bool ign_usage_count) 1140 { 1141 unsigned long flags; 1142 int retval; 1143 1144 spin_lock_irqsave(&dev->power.lock, flags); 1145 if (dev->power.disable_depth > 0) { 1146 retval = -EINVAL; 1147 } else if (dev->power.runtime_status != RPM_ACTIVE) { 1148 retval = 0; 1149 } else if (ign_usage_count) { 1150 retval = 1; 1151 atomic_inc(&dev->power.usage_count); 1152 } else { 1153 retval = atomic_inc_not_zero(&dev->power.usage_count); 1154 } 1155 trace_rpm_usage_rcuidle(dev, 0); 1156 spin_unlock_irqrestore(&dev->power.lock, flags); 1157 1158 return retval; 1159 } 1160 EXPORT_SYMBOL_GPL(pm_runtime_get_if_active); 1161 1162 /** 1163 * __pm_runtime_set_status - Set runtime PM status of a device. 1164 * @dev: Device to handle. 1165 * @status: New runtime PM status of the device. 1166 * 1167 * If runtime PM of the device is disabled or its power.runtime_error field is 1168 * different from zero, the status may be changed either to RPM_ACTIVE, or to 1169 * RPM_SUSPENDED, as long as that reflects the actual state of the device. 1170 * However, if the device has a parent and the parent is not active, and the 1171 * parent's power.ignore_children flag is unset, the device's status cannot be 1172 * set to RPM_ACTIVE, so -EBUSY is returned in that case. 1173 * 1174 * If successful, __pm_runtime_set_status() clears the power.runtime_error field 1175 * and the device parent's counter of unsuspended children is modified to 1176 * reflect the new status. If the new status is RPM_SUSPENDED, an idle 1177 * notification request for the parent is submitted. 1178 * 1179 * If @dev has any suppliers (as reflected by device links to them), and @status 1180 * is RPM_ACTIVE, they will be activated upfront and if the activation of one 1181 * of them fails, the status of @dev will be changed to RPM_SUSPENDED (instead 1182 * of the @status value) and the suppliers will be deacticated on exit. The 1183 * error returned by the failing supplier activation will be returned in that 1184 * case. 1185 */ 1186 int __pm_runtime_set_status(struct device *dev, unsigned int status) 1187 { 1188 struct device *parent = dev->parent; 1189 bool notify_parent = false; 1190 int error = 0; 1191 1192 if (status != RPM_ACTIVE && status != RPM_SUSPENDED) 1193 return -EINVAL; 1194 1195 spin_lock_irq(&dev->power.lock); 1196 1197 /* 1198 * Prevent PM-runtime from being enabled for the device or return an 1199 * error if it is enabled already and working. 1200 */ 1201 if (dev->power.runtime_error || dev->power.disable_depth) 1202 dev->power.disable_depth++; 1203 else 1204 error = -EAGAIN; 1205 1206 spin_unlock_irq(&dev->power.lock); 1207 1208 if (error) 1209 return error; 1210 1211 /* 1212 * If the new status is RPM_ACTIVE, the suppliers can be activated 1213 * upfront regardless of the current status, because next time 1214 * rpm_put_suppliers() runs, the rpm_active refcounts of the links 1215 * involved will be dropped down to one anyway. 1216 */ 1217 if (status == RPM_ACTIVE) { 1218 int idx = device_links_read_lock(); 1219 1220 error = rpm_get_suppliers(dev); 1221 if (error) 1222 status = RPM_SUSPENDED; 1223 1224 device_links_read_unlock(idx); 1225 } 1226 1227 spin_lock_irq(&dev->power.lock); 1228 1229 if (dev->power.runtime_status == status || !parent) 1230 goto out_set; 1231 1232 if (status == RPM_SUSPENDED) { 1233 atomic_add_unless(&parent->power.child_count, -1, 0); 1234 notify_parent = !parent->power.ignore_children; 1235 } else { 1236 spin_lock_nested(&parent->power.lock, SINGLE_DEPTH_NESTING); 1237 1238 /* 1239 * It is invalid to put an active child under a parent that is 1240 * not active, has runtime PM enabled and the 1241 * 'power.ignore_children' flag unset. 1242 */ 1243 if (!parent->power.disable_depth 1244 && !parent->power.ignore_children 1245 && parent->power.runtime_status != RPM_ACTIVE) { 1246 dev_err(dev, "runtime PM trying to activate child device %s but parent (%s) is not active\n", 1247 dev_name(dev), 1248 dev_name(parent)); 1249 error = -EBUSY; 1250 } else if (dev->power.runtime_status == RPM_SUSPENDED) { 1251 atomic_inc(&parent->power.child_count); 1252 } 1253 1254 spin_unlock(&parent->power.lock); 1255 1256 if (error) { 1257 status = RPM_SUSPENDED; 1258 goto out; 1259 } 1260 } 1261 1262 out_set: 1263 __update_runtime_status(dev, status); 1264 if (!error) 1265 dev->power.runtime_error = 0; 1266 1267 out: 1268 spin_unlock_irq(&dev->power.lock); 1269 1270 if (notify_parent) 1271 pm_request_idle(parent); 1272 1273 if (status == RPM_SUSPENDED) { 1274 int idx = device_links_read_lock(); 1275 1276 rpm_put_suppliers(dev); 1277 1278 device_links_read_unlock(idx); 1279 } 1280 1281 pm_runtime_enable(dev); 1282 1283 return error; 1284 } 1285 EXPORT_SYMBOL_GPL(__pm_runtime_set_status); 1286 1287 /** 1288 * __pm_runtime_barrier - Cancel pending requests and wait for completions. 1289 * @dev: Device to handle. 1290 * 1291 * Flush all pending requests for the device from pm_wq and wait for all 1292 * runtime PM operations involving the device in progress to complete. 1293 * 1294 * Should be called under dev->power.lock with interrupts disabled. 1295 */ 1296 static void __pm_runtime_barrier(struct device *dev) 1297 { 1298 pm_runtime_deactivate_timer(dev); 1299 1300 if (dev->power.request_pending) { 1301 dev->power.request = RPM_REQ_NONE; 1302 spin_unlock_irq(&dev->power.lock); 1303 1304 cancel_work_sync(&dev->power.work); 1305 1306 spin_lock_irq(&dev->power.lock); 1307 dev->power.request_pending = false; 1308 } 1309 1310 if (dev->power.runtime_status == RPM_SUSPENDING 1311 || dev->power.runtime_status == RPM_RESUMING 1312 || dev->power.idle_notification) { 1313 DEFINE_WAIT(wait); 1314 1315 /* Suspend, wake-up or idle notification in progress. */ 1316 for (;;) { 1317 prepare_to_wait(&dev->power.wait_queue, &wait, 1318 TASK_UNINTERRUPTIBLE); 1319 if (dev->power.runtime_status != RPM_SUSPENDING 1320 && dev->power.runtime_status != RPM_RESUMING 1321 && !dev->power.idle_notification) 1322 break; 1323 spin_unlock_irq(&dev->power.lock); 1324 1325 schedule(); 1326 1327 spin_lock_irq(&dev->power.lock); 1328 } 1329 finish_wait(&dev->power.wait_queue, &wait); 1330 } 1331 } 1332 1333 /** 1334 * pm_runtime_barrier - Flush pending requests and wait for completions. 1335 * @dev: Device to handle. 1336 * 1337 * Prevent the device from being suspended by incrementing its usage counter and 1338 * if there's a pending resume request for the device, wake the device up. 1339 * Next, make sure that all pending requests for the device have been flushed 1340 * from pm_wq and wait for all runtime PM operations involving the device in 1341 * progress to complete. 1342 * 1343 * Return value: 1344 * 1, if there was a resume request pending and the device had to be woken up, 1345 * 0, otherwise 1346 */ 1347 int pm_runtime_barrier(struct device *dev) 1348 { 1349 int retval = 0; 1350 1351 pm_runtime_get_noresume(dev); 1352 spin_lock_irq(&dev->power.lock); 1353 1354 if (dev->power.request_pending 1355 && dev->power.request == RPM_REQ_RESUME) { 1356 rpm_resume(dev, 0); 1357 retval = 1; 1358 } 1359 1360 __pm_runtime_barrier(dev); 1361 1362 spin_unlock_irq(&dev->power.lock); 1363 pm_runtime_put_noidle(dev); 1364 1365 return retval; 1366 } 1367 EXPORT_SYMBOL_GPL(pm_runtime_barrier); 1368 1369 /** 1370 * __pm_runtime_disable - Disable runtime PM of a device. 1371 * @dev: Device to handle. 1372 * @check_resume: If set, check if there's a resume request for the device. 1373 * 1374 * Increment power.disable_depth for the device and if it was zero previously, 1375 * cancel all pending runtime PM requests for the device and wait for all 1376 * operations in progress to complete. The device can be either active or 1377 * suspended after its runtime PM has been disabled. 1378 * 1379 * If @check_resume is set and there's a resume request pending when 1380 * __pm_runtime_disable() is called and power.disable_depth is zero, the 1381 * function will wake up the device before disabling its runtime PM. 1382 */ 1383 void __pm_runtime_disable(struct device *dev, bool check_resume) 1384 { 1385 spin_lock_irq(&dev->power.lock); 1386 1387 if (dev->power.disable_depth > 0) { 1388 dev->power.disable_depth++; 1389 goto out; 1390 } 1391 1392 /* 1393 * Wake up the device if there's a resume request pending, because that 1394 * means there probably is some I/O to process and disabling runtime PM 1395 * shouldn't prevent the device from processing the I/O. 1396 */ 1397 if (check_resume && dev->power.request_pending 1398 && dev->power.request == RPM_REQ_RESUME) { 1399 /* 1400 * Prevent suspends and idle notifications from being carried 1401 * out after we have woken up the device. 1402 */ 1403 pm_runtime_get_noresume(dev); 1404 1405 rpm_resume(dev, 0); 1406 1407 pm_runtime_put_noidle(dev); 1408 } 1409 1410 /* Update time accounting before disabling PM-runtime. */ 1411 update_pm_runtime_accounting(dev); 1412 1413 if (!dev->power.disable_depth++) 1414 __pm_runtime_barrier(dev); 1415 1416 out: 1417 spin_unlock_irq(&dev->power.lock); 1418 } 1419 EXPORT_SYMBOL_GPL(__pm_runtime_disable); 1420 1421 /** 1422 * pm_runtime_enable - Enable runtime PM of a device. 1423 * @dev: Device to handle. 1424 */ 1425 void pm_runtime_enable(struct device *dev) 1426 { 1427 unsigned long flags; 1428 1429 spin_lock_irqsave(&dev->power.lock, flags); 1430 1431 if (dev->power.disable_depth > 0) { 1432 dev->power.disable_depth--; 1433 1434 /* About to enable runtime pm, set accounting_timestamp to now */ 1435 if (!dev->power.disable_depth) 1436 dev->power.accounting_timestamp = ktime_get_mono_fast_ns(); 1437 } else { 1438 dev_warn(dev, "Unbalanced %s!\n", __func__); 1439 } 1440 1441 WARN(!dev->power.disable_depth && 1442 dev->power.runtime_status == RPM_SUSPENDED && 1443 !dev->power.ignore_children && 1444 atomic_read(&dev->power.child_count) > 0, 1445 "Enabling runtime PM for inactive device (%s) with active children\n", 1446 dev_name(dev)); 1447 1448 spin_unlock_irqrestore(&dev->power.lock, flags); 1449 } 1450 EXPORT_SYMBOL_GPL(pm_runtime_enable); 1451 1452 /** 1453 * pm_runtime_forbid - Block runtime PM of a device. 1454 * @dev: Device to handle. 1455 * 1456 * Increase the device's usage count and clear its power.runtime_auto flag, 1457 * so that it cannot be suspended at run time until pm_runtime_allow() is called 1458 * for it. 1459 */ 1460 void pm_runtime_forbid(struct device *dev) 1461 { 1462 spin_lock_irq(&dev->power.lock); 1463 if (!dev->power.runtime_auto) 1464 goto out; 1465 1466 dev->power.runtime_auto = false; 1467 atomic_inc(&dev->power.usage_count); 1468 rpm_resume(dev, 0); 1469 1470 out: 1471 spin_unlock_irq(&dev->power.lock); 1472 } 1473 EXPORT_SYMBOL_GPL(pm_runtime_forbid); 1474 1475 /** 1476 * pm_runtime_allow - Unblock runtime PM of a device. 1477 * @dev: Device to handle. 1478 * 1479 * Decrease the device's usage count and set its power.runtime_auto flag. 1480 */ 1481 void pm_runtime_allow(struct device *dev) 1482 { 1483 spin_lock_irq(&dev->power.lock); 1484 if (dev->power.runtime_auto) 1485 goto out; 1486 1487 dev->power.runtime_auto = true; 1488 if (atomic_dec_and_test(&dev->power.usage_count)) 1489 rpm_idle(dev, RPM_AUTO | RPM_ASYNC); 1490 else 1491 trace_rpm_usage_rcuidle(dev, RPM_AUTO | RPM_ASYNC); 1492 1493 out: 1494 spin_unlock_irq(&dev->power.lock); 1495 } 1496 EXPORT_SYMBOL_GPL(pm_runtime_allow); 1497 1498 /** 1499 * pm_runtime_no_callbacks - Ignore runtime PM callbacks for a device. 1500 * @dev: Device to handle. 1501 * 1502 * Set the power.no_callbacks flag, which tells the PM core that this 1503 * device is power-managed through its parent and has no runtime PM 1504 * callbacks of its own. The runtime sysfs attributes will be removed. 1505 */ 1506 void pm_runtime_no_callbacks(struct device *dev) 1507 { 1508 spin_lock_irq(&dev->power.lock); 1509 dev->power.no_callbacks = 1; 1510 spin_unlock_irq(&dev->power.lock); 1511 if (device_is_registered(dev)) 1512 rpm_sysfs_remove(dev); 1513 } 1514 EXPORT_SYMBOL_GPL(pm_runtime_no_callbacks); 1515 1516 /** 1517 * pm_runtime_irq_safe - Leave interrupts disabled during callbacks. 1518 * @dev: Device to handle 1519 * 1520 * Set the power.irq_safe flag, which tells the PM core that the 1521 * ->runtime_suspend() and ->runtime_resume() callbacks for this device should 1522 * always be invoked with the spinlock held and interrupts disabled. It also 1523 * causes the parent's usage counter to be permanently incremented, preventing 1524 * the parent from runtime suspending -- otherwise an irq-safe child might have 1525 * to wait for a non-irq-safe parent. 1526 */ 1527 void pm_runtime_irq_safe(struct device *dev) 1528 { 1529 if (dev->parent) 1530 pm_runtime_get_sync(dev->parent); 1531 spin_lock_irq(&dev->power.lock); 1532 dev->power.irq_safe = 1; 1533 spin_unlock_irq(&dev->power.lock); 1534 } 1535 EXPORT_SYMBOL_GPL(pm_runtime_irq_safe); 1536 1537 /** 1538 * update_autosuspend - Handle a change to a device's autosuspend settings. 1539 * @dev: Device to handle. 1540 * @old_delay: The former autosuspend_delay value. 1541 * @old_use: The former use_autosuspend value. 1542 * 1543 * Prevent runtime suspend if the new delay is negative and use_autosuspend is 1544 * set; otherwise allow it. Send an idle notification if suspends are allowed. 1545 * 1546 * This function must be called under dev->power.lock with interrupts disabled. 1547 */ 1548 static void update_autosuspend(struct device *dev, int old_delay, int old_use) 1549 { 1550 int delay = dev->power.autosuspend_delay; 1551 1552 /* Should runtime suspend be prevented now? */ 1553 if (dev->power.use_autosuspend && delay < 0) { 1554 1555 /* If it used to be allowed then prevent it. */ 1556 if (!old_use || old_delay >= 0) { 1557 atomic_inc(&dev->power.usage_count); 1558 rpm_resume(dev, 0); 1559 } else { 1560 trace_rpm_usage_rcuidle(dev, 0); 1561 } 1562 } 1563 1564 /* Runtime suspend should be allowed now. */ 1565 else { 1566 1567 /* If it used to be prevented then allow it. */ 1568 if (old_use && old_delay < 0) 1569 atomic_dec(&dev->power.usage_count); 1570 1571 /* Maybe we can autosuspend now. */ 1572 rpm_idle(dev, RPM_AUTO); 1573 } 1574 } 1575 1576 /** 1577 * pm_runtime_set_autosuspend_delay - Set a device's autosuspend_delay value. 1578 * @dev: Device to handle. 1579 * @delay: Value of the new delay in milliseconds. 1580 * 1581 * Set the device's power.autosuspend_delay value. If it changes to negative 1582 * and the power.use_autosuspend flag is set, prevent runtime suspends. If it 1583 * changes the other way, allow runtime suspends. 1584 */ 1585 void pm_runtime_set_autosuspend_delay(struct device *dev, int delay) 1586 { 1587 int old_delay, old_use; 1588 1589 spin_lock_irq(&dev->power.lock); 1590 old_delay = dev->power.autosuspend_delay; 1591 old_use = dev->power.use_autosuspend; 1592 dev->power.autosuspend_delay = delay; 1593 update_autosuspend(dev, old_delay, old_use); 1594 spin_unlock_irq(&dev->power.lock); 1595 } 1596 EXPORT_SYMBOL_GPL(pm_runtime_set_autosuspend_delay); 1597 1598 /** 1599 * __pm_runtime_use_autosuspend - Set a device's use_autosuspend flag. 1600 * @dev: Device to handle. 1601 * @use: New value for use_autosuspend. 1602 * 1603 * Set the device's power.use_autosuspend flag, and allow or prevent runtime 1604 * suspends as needed. 1605 */ 1606 void __pm_runtime_use_autosuspend(struct device *dev, bool use) 1607 { 1608 int old_delay, old_use; 1609 1610 spin_lock_irq(&dev->power.lock); 1611 old_delay = dev->power.autosuspend_delay; 1612 old_use = dev->power.use_autosuspend; 1613 dev->power.use_autosuspend = use; 1614 update_autosuspend(dev, old_delay, old_use); 1615 spin_unlock_irq(&dev->power.lock); 1616 } 1617 EXPORT_SYMBOL_GPL(__pm_runtime_use_autosuspend); 1618 1619 /** 1620 * pm_runtime_init - Initialize runtime PM fields in given device object. 1621 * @dev: Device object to initialize. 1622 */ 1623 void pm_runtime_init(struct device *dev) 1624 { 1625 dev->power.runtime_status = RPM_SUSPENDED; 1626 dev->power.idle_notification = false; 1627 1628 dev->power.disable_depth = 1; 1629 atomic_set(&dev->power.usage_count, 0); 1630 1631 dev->power.runtime_error = 0; 1632 1633 atomic_set(&dev->power.child_count, 0); 1634 pm_suspend_ignore_children(dev, false); 1635 dev->power.runtime_auto = true; 1636 1637 dev->power.request_pending = false; 1638 dev->power.request = RPM_REQ_NONE; 1639 dev->power.deferred_resume = false; 1640 INIT_WORK(&dev->power.work, pm_runtime_work); 1641 1642 dev->power.timer_expires = 0; 1643 hrtimer_init(&dev->power.suspend_timer, CLOCK_MONOTONIC, HRTIMER_MODE_ABS); 1644 dev->power.suspend_timer.function = pm_suspend_timer_fn; 1645 1646 init_waitqueue_head(&dev->power.wait_queue); 1647 } 1648 1649 /** 1650 * pm_runtime_reinit - Re-initialize runtime PM fields in given device object. 1651 * @dev: Device object to re-initialize. 1652 */ 1653 void pm_runtime_reinit(struct device *dev) 1654 { 1655 if (!pm_runtime_enabled(dev)) { 1656 if (dev->power.runtime_status == RPM_ACTIVE) 1657 pm_runtime_set_suspended(dev); 1658 if (dev->power.irq_safe) { 1659 spin_lock_irq(&dev->power.lock); 1660 dev->power.irq_safe = 0; 1661 spin_unlock_irq(&dev->power.lock); 1662 if (dev->parent) 1663 pm_runtime_put(dev->parent); 1664 } 1665 } 1666 } 1667 1668 /** 1669 * pm_runtime_remove - Prepare for removing a device from device hierarchy. 1670 * @dev: Device object being removed from device hierarchy. 1671 */ 1672 void pm_runtime_remove(struct device *dev) 1673 { 1674 __pm_runtime_disable(dev, false); 1675 pm_runtime_reinit(dev); 1676 } 1677 1678 /** 1679 * pm_runtime_get_suppliers - Resume and reference-count supplier devices. 1680 * @dev: Consumer device. 1681 */ 1682 void pm_runtime_get_suppliers(struct device *dev) 1683 { 1684 struct device_link *link; 1685 int idx; 1686 1687 idx = device_links_read_lock(); 1688 1689 list_for_each_entry_rcu(link, &dev->links.suppliers, c_node, 1690 device_links_read_lock_held()) 1691 if (link->flags & DL_FLAG_PM_RUNTIME) { 1692 link->supplier_preactivated = true; 1693 pm_runtime_get_sync(link->supplier); 1694 refcount_inc(&link->rpm_active); 1695 } 1696 1697 device_links_read_unlock(idx); 1698 } 1699 1700 /** 1701 * pm_runtime_put_suppliers - Drop references to supplier devices. 1702 * @dev: Consumer device. 1703 */ 1704 void pm_runtime_put_suppliers(struct device *dev) 1705 { 1706 struct device_link *link; 1707 unsigned long flags; 1708 bool put; 1709 int idx; 1710 1711 idx = device_links_read_lock(); 1712 1713 list_for_each_entry_rcu(link, &dev->links.suppliers, c_node, 1714 device_links_read_lock_held()) 1715 if (link->supplier_preactivated) { 1716 link->supplier_preactivated = false; 1717 spin_lock_irqsave(&dev->power.lock, flags); 1718 put = pm_runtime_status_suspended(dev) && 1719 refcount_dec_not_one(&link->rpm_active); 1720 spin_unlock_irqrestore(&dev->power.lock, flags); 1721 if (put) 1722 pm_runtime_put(link->supplier); 1723 } 1724 1725 device_links_read_unlock(idx); 1726 } 1727 1728 void pm_runtime_new_link(struct device *dev) 1729 { 1730 spin_lock_irq(&dev->power.lock); 1731 dev->power.links_count++; 1732 spin_unlock_irq(&dev->power.lock); 1733 } 1734 1735 static void pm_runtime_drop_link_count(struct device *dev) 1736 { 1737 spin_lock_irq(&dev->power.lock); 1738 WARN_ON(dev->power.links_count == 0); 1739 dev->power.links_count--; 1740 spin_unlock_irq(&dev->power.lock); 1741 } 1742 1743 /** 1744 * pm_runtime_drop_link - Prepare for device link removal. 1745 * @link: Device link going away. 1746 * 1747 * Drop the link count of the consumer end of @link and decrement the supplier 1748 * device's runtime PM usage counter as many times as needed to drop all of the 1749 * PM runtime reference to it from the consumer. 1750 */ 1751 void pm_runtime_drop_link(struct device_link *link) 1752 { 1753 if (!(link->flags & DL_FLAG_PM_RUNTIME)) 1754 return; 1755 1756 pm_runtime_drop_link_count(link->consumer); 1757 1758 while (refcount_dec_not_one(&link->rpm_active)) 1759 pm_runtime_put(link->supplier); 1760 } 1761 1762 static bool pm_runtime_need_not_resume(struct device *dev) 1763 { 1764 return atomic_read(&dev->power.usage_count) <= 1 && 1765 (atomic_read(&dev->power.child_count) == 0 || 1766 dev->power.ignore_children); 1767 } 1768 1769 /** 1770 * pm_runtime_force_suspend - Force a device into suspend state if needed. 1771 * @dev: Device to suspend. 1772 * 1773 * Disable runtime PM so we safely can check the device's runtime PM status and 1774 * if it is active, invoke its ->runtime_suspend callback to suspend it and 1775 * change its runtime PM status field to RPM_SUSPENDED. Also, if the device's 1776 * usage and children counters don't indicate that the device was in use before 1777 * the system-wide transition under way, decrement its parent's children counter 1778 * (if there is a parent). Keep runtime PM disabled to preserve the state 1779 * unless we encounter errors. 1780 * 1781 * Typically this function may be invoked from a system suspend callback to make 1782 * sure the device is put into low power state and it should only be used during 1783 * system-wide PM transitions to sleep states. It assumes that the analogous 1784 * pm_runtime_force_resume() will be used to resume the device. 1785 */ 1786 int pm_runtime_force_suspend(struct device *dev) 1787 { 1788 int (*callback)(struct device *); 1789 int ret; 1790 1791 pm_runtime_disable(dev); 1792 if (pm_runtime_status_suspended(dev)) 1793 return 0; 1794 1795 callback = RPM_GET_CALLBACK(dev, runtime_suspend); 1796 1797 ret = callback ? callback(dev) : 0; 1798 if (ret) 1799 goto err; 1800 1801 /* 1802 * If the device can stay in suspend after the system-wide transition 1803 * to the working state that will follow, drop the children counter of 1804 * its parent, but set its status to RPM_SUSPENDED anyway in case this 1805 * function will be called again for it in the meantime. 1806 */ 1807 if (pm_runtime_need_not_resume(dev)) 1808 pm_runtime_set_suspended(dev); 1809 else 1810 __update_runtime_status(dev, RPM_SUSPENDED); 1811 1812 return 0; 1813 1814 err: 1815 pm_runtime_enable(dev); 1816 return ret; 1817 } 1818 EXPORT_SYMBOL_GPL(pm_runtime_force_suspend); 1819 1820 /** 1821 * pm_runtime_force_resume - Force a device into resume state if needed. 1822 * @dev: Device to resume. 1823 * 1824 * Prior invoking this function we expect the user to have brought the device 1825 * into low power state by a call to pm_runtime_force_suspend(). Here we reverse 1826 * those actions and bring the device into full power, if it is expected to be 1827 * used on system resume. In the other case, we defer the resume to be managed 1828 * via runtime PM. 1829 * 1830 * Typically this function may be invoked from a system resume callback. 1831 */ 1832 int pm_runtime_force_resume(struct device *dev) 1833 { 1834 int (*callback)(struct device *); 1835 int ret = 0; 1836 1837 if (!pm_runtime_status_suspended(dev) || pm_runtime_need_not_resume(dev)) 1838 goto out; 1839 1840 /* 1841 * The value of the parent's children counter is correct already, so 1842 * just update the status of the device. 1843 */ 1844 __update_runtime_status(dev, RPM_ACTIVE); 1845 1846 callback = RPM_GET_CALLBACK(dev, runtime_resume); 1847 1848 ret = callback ? callback(dev) : 0; 1849 if (ret) { 1850 pm_runtime_set_suspended(dev); 1851 goto out; 1852 } 1853 1854 pm_runtime_mark_last_busy(dev); 1855 out: 1856 pm_runtime_enable(dev); 1857 return ret; 1858 } 1859 EXPORT_SYMBOL_GPL(pm_runtime_force_resume); 1860