Lines Matching +full:wakeup +full:- +full:source
1 // SPDX-License-Identifier: GPL-2.0
3 * drivers/base/power/wakeup.c - System wakeup events framework
27 * if wakeup events are registered during or immediately before the transition.
31 /* First wakeup IRQ seen by the kernel in the last cycle. */
39 * Combined counters of registered wakeup events and wakeup events in progress.
46 #define MAX_IN_PROGRESS ((1 << IN_PROGRESS_BITS) - 1)
77 * wakeup_source_create - Create a struct wakeup_source object.
78 * @name: Name of the new wakeup source.
93 ws->name = ws_name; in wakeup_source_create()
98 ws->id = id; in wakeup_source_create()
103 kfree_const(ws->name); in wakeup_source_create()
120 if (ws->event_count) { in wakeup_source_record()
122 ktime_add(deleted_ws.total_time, ws->total_time); in wakeup_source_record()
125 ws->prevent_sleep_time); in wakeup_source_record()
127 ktime_compare(deleted_ws.max_time, ws->max_time) > 0 ? in wakeup_source_record()
128 deleted_ws.max_time : ws->max_time; in wakeup_source_record()
129 deleted_ws.event_count += ws->event_count; in wakeup_source_record()
130 deleted_ws.active_count += ws->active_count; in wakeup_source_record()
131 deleted_ws.relax_count += ws->relax_count; in wakeup_source_record()
132 deleted_ws.expire_count += ws->expire_count; in wakeup_source_record()
133 deleted_ws.wakeup_count += ws->wakeup_count; in wakeup_source_record()
141 ida_free(&wakeup_ida, ws->id); in wakeup_source_free()
142 kfree_const(ws->name); in wakeup_source_free()
147 * wakeup_source_destroy - Destroy a struct wakeup_source object.
148 * @ws: Wakeup source to destroy.
150 * Use only for wakeup source objects created with wakeup_source_create().
164 * wakeup_source_add - Add given object to the list of wakeup sources.
165 * @ws: Wakeup source object to add to the list.
174 spin_lock_init(&ws->lock); in wakeup_source_add()
175 timer_setup(&ws->timer, pm_wakeup_timer_fn, 0); in wakeup_source_add()
176 ws->active = false; in wakeup_source_add()
179 list_add_rcu(&ws->entry, &wakeup_sources); in wakeup_source_add()
185 * wakeup_source_remove - Remove given object from the wakeup sources list.
186 * @ws: Wakeup source object to remove from the list.
196 list_del_rcu(&ws->entry); in wakeup_source_remove()
200 del_timer_sync(&ws->timer); in wakeup_source_remove()
203 * this wakeup source as not registered. in wakeup_source_remove()
205 ws->timer.function = NULL; in wakeup_source_remove()
210 * wakeup_source_register - Create wakeup source and add it to the list.
211 * @dev: Device this wakeup source is associated with (or NULL if virtual).
212 * @name: Name of the wakeup source to register.
236 * wakeup_source_unregister - Remove wakeup source from the list and remove it.
237 * @ws: Wakeup source object to unregister.
243 if (ws->dev) in wakeup_source_unregister()
252 * wakeup_sources_read_lock - Lock wakeup source list for read.
264 * wakeup_sources_read_unlock - Unlock wakeup source list.
274 * wakeup_sources_walk_start - Begin a walk on wakeup source list
276 * Returns first object of the list of wakeup sources.
278 * Note that to be safe, wakeup sources list needs to be locked by calling
285 return list_entry_rcu(ws_head->next, struct wakeup_source, entry); in wakeup_sources_walk_start()
290 * wakeup_sources_walk_next - Get next wakeup source from the list
291 * @ws: Previous wakeup source object
293 * Note that to be safe, wakeup sources list needs to be locked by calling
300 return list_next_or_null_rcu(ws_head, &ws->entry, in wakeup_sources_walk_next()
306 * device_wakeup_attach - Attach a wakeup source object to a device object.
308 * @ws: Wakeup source object to attach to @dev.
310 * This causes @dev to be treated as a wakeup device.
314 spin_lock_irq(&dev->power.lock); in device_wakeup_attach()
315 if (dev->power.wakeup) { in device_wakeup_attach()
316 spin_unlock_irq(&dev->power.lock); in device_wakeup_attach()
317 return -EEXIST; in device_wakeup_attach()
319 dev->power.wakeup = ws; in device_wakeup_attach()
320 if (dev->power.wakeirq) in device_wakeup_attach()
321 device_wakeup_attach_irq(dev, dev->power.wakeirq); in device_wakeup_attach()
322 spin_unlock_irq(&dev->power.lock); in device_wakeup_attach()
327 * device_wakeup_enable - Enable given device to be a wakeup source.
330 * Create a wakeup source object, register it and attach it to @dev.
337 if (!dev || !dev->power.can_wakeup) in device_wakeup_enable()
338 return -EINVAL; in device_wakeup_enable()
345 return -ENOMEM; in device_wakeup_enable()
356 * device_wakeup_attach_irq - Attach a wakeirq to a wakeup source
360 * Attach a device wakeirq to the wakeup source so the device
371 ws = dev->power.wakeup; in device_wakeup_attach_irq()
375 if (ws->wakeirq) in device_wakeup_attach_irq()
376 dev_err(dev, "Leftover wakeup IRQ found, overriding\n"); in device_wakeup_attach_irq()
378 ws->wakeirq = wakeirq; in device_wakeup_attach_irq()
382 * device_wakeup_detach_irq - Detach a wakeirq from a wakeup source
385 * Removes a device wakeirq from the wakeup source.
393 ws = dev->power.wakeup; in device_wakeup_detach_irq()
395 ws->wakeirq = NULL; in device_wakeup_detach_irq()
399 * device_wakeup_arm_wake_irqs -
410 dev_pm_arm_wake_irq(ws->wakeirq); in device_wakeup_arm_wake_irqs()
415 * device_wakeup_disarm_wake_irqs -
426 dev_pm_disarm_wake_irq(ws->wakeirq); in device_wakeup_disarm_wake_irqs()
431 * device_wakeup_detach - Detach a device's wakeup source object from it.
432 * @dev: Device to detach the wakeup source object from.
434 * After it returns, @dev will not be treated as a wakeup device any more.
440 spin_lock_irq(&dev->power.lock); in device_wakeup_detach()
441 ws = dev->power.wakeup; in device_wakeup_detach()
442 dev->power.wakeup = NULL; in device_wakeup_detach()
443 spin_unlock_irq(&dev->power.lock); in device_wakeup_detach()
448 * device_wakeup_disable - Do not regard a device as a wakeup source any more.
451 * Detach the @dev's wakeup source object from it, unregister this wakeup source
458 if (!dev || !dev->power.can_wakeup) in device_wakeup_disable()
459 return -EINVAL; in device_wakeup_disable()
468 * device_set_wakeup_capable - Set/reset device wakeup capability flag.
473 * wakeup-related attributes to sysfs. Otherwise, unset the @dev's
474 * power.can_wakeup flag and remove its wakeup-related attributes from sysfs.
481 if (!!dev->power.can_wakeup == !!capable) in device_set_wakeup_capable()
484 dev->power.can_wakeup = capable; in device_set_wakeup_capable()
485 if (device_is_registered(dev) && !list_empty(&dev->power.entry)) { in device_set_wakeup_capable()
490 dev_info(dev, "Wakeup sysfs attributes not added\n"); in device_set_wakeup_capable()
499 * device_set_wakeup_enable - Enable or disable a device to wake up the system.
510 * wakeup_source_not_registered - validate the given wakeup source.
511 * @ws: Wakeup source to be validated.
516 * Use timer struct to check if the given source is initialized in wakeup_source_not_registered()
519 return ws->timer.function != pm_wakeup_timer_fn; in wakeup_source_not_registered()
523 * The functions below use the observation that each wakeup event starts a
525 * will end depends on how the wakeup event is going to be processed after being
529 * First, a wakeup event may be detected by the same functional unit that will
537 * Second, a wakeup event may be detected by one functional unit and processed
551 * wakeup_source_activate - Mark given wakeup source as active.
552 * @ws: Wakeup source to handle.
555 * core of the event by incrementing the counter of the wakeup events being
563 "unregistered wakeup source\n")) in wakeup_source_activate()
566 ws->active = true; in wakeup_source_activate()
567 ws->active_count++; in wakeup_source_activate()
568 ws->last_time = ktime_get(); in wakeup_source_activate()
569 if (ws->autosleep_enabled) in wakeup_source_activate()
570 ws->start_prevent_time = ws->last_time; in wakeup_source_activate()
575 trace_wakeup_source_activate(ws->name, cec); in wakeup_source_activate()
579 * wakeup_source_report_event - Report wakeup event using the given source.
580 * @ws: Wakeup source to report the event for.
581 * @hard: If set, abort suspends in progress and wake up from suspend-to-idle.
585 ws->event_count++; in wakeup_source_report_event()
588 ws->wakeup_count++; in wakeup_source_report_event()
590 if (!ws->active) in wakeup_source_report_event()
598 * __pm_stay_awake - Notify the PM core of a wakeup event.
599 * @ws: Wakeup source object associated with the source of the event.
610 spin_lock_irqsave(&ws->lock, flags); in __pm_stay_awake()
613 del_timer(&ws->timer); in __pm_stay_awake()
614 ws->timer_expires = 0; in __pm_stay_awake()
616 spin_unlock_irqrestore(&ws->lock, flags); in __pm_stay_awake()
621 * pm_stay_awake - Notify the PM core that a wakeup event is being processed.
622 * @dev: Device the wakeup event is related to.
624 * Notify the PM core of a wakeup event (signaled by @dev) by calling
625 * __pm_stay_awake for the @dev's wakeup source object.
627 * Call this function after detecting of a wakeup event if pm_relax() is going
638 spin_lock_irqsave(&dev->power.lock, flags); in pm_stay_awake()
639 __pm_stay_awake(dev->power.wakeup); in pm_stay_awake()
640 spin_unlock_irqrestore(&dev->power.lock, flags); in pm_stay_awake()
647 ktime_t delta = ktime_sub(now, ws->start_prevent_time); in update_prevent_sleep_time()
648 ws->prevent_sleep_time = ktime_add(ws->prevent_sleep_time, delta); in update_prevent_sleep_time()
656 * wakeup_source_deactivate - Mark given wakeup source as inactive.
657 * @ws: Wakeup source to handle.
659 * Update the @ws' statistics and notify the PM core that the wakeup source has
660 * become inactive by decrementing the counter of wakeup events being processed
661 * and incrementing the counter of registered wakeup events.
669 ws->relax_count++; in wakeup_source_deactivate()
675 * will set ws->active. Then, ws->active may be cleared immediately in wakeup_source_deactivate()
677 * case ws->relax_count will be different from ws->active_count. in wakeup_source_deactivate()
679 if (ws->relax_count != ws->active_count) { in wakeup_source_deactivate()
680 ws->relax_count--; in wakeup_source_deactivate()
684 ws->active = false; in wakeup_source_deactivate()
687 duration = ktime_sub(now, ws->last_time); in wakeup_source_deactivate()
688 ws->total_time = ktime_add(ws->total_time, duration); in wakeup_source_deactivate()
689 if (ktime_to_ns(duration) > ktime_to_ns(ws->max_time)) in wakeup_source_deactivate()
690 ws->max_time = duration; in wakeup_source_deactivate()
692 ws->last_time = now; in wakeup_source_deactivate()
693 del_timer(&ws->timer); in wakeup_source_deactivate()
694 ws->timer_expires = 0; in wakeup_source_deactivate()
696 if (ws->autosleep_enabled) in wakeup_source_deactivate()
700 * Increment the counter of registered wakeup events and decrement the in wakeup_source_deactivate()
701 * counter of wakeup events in progress simultaneously. in wakeup_source_deactivate()
704 trace_wakeup_source_deactivate(ws->name, cec); in wakeup_source_deactivate()
712 * __pm_relax - Notify the PM core that processing of a wakeup event has ended.
713 * @ws: Wakeup source object associated with the source of the event.
715 * Call this function for wakeup events whose processing started with calling
727 spin_lock_irqsave(&ws->lock, flags); in __pm_relax()
728 if (ws->active) in __pm_relax()
730 spin_unlock_irqrestore(&ws->lock, flags); in __pm_relax()
735 * pm_relax - Notify the PM core that processing of a wakeup event has ended.
738 * Execute __pm_relax() for the @dev's wakeup source object.
747 spin_lock_irqsave(&dev->power.lock, flags); in pm_relax()
748 __pm_relax(dev->power.wakeup); in pm_relax()
749 spin_unlock_irqrestore(&dev->power.lock, flags); in pm_relax()
754 * pm_wakeup_timer_fn - Delayed finalization of a wakeup event.
757 * Call wakeup_source_deactivate() for the wakeup source whose address is stored
766 spin_lock_irqsave(&ws->lock, flags); in pm_wakeup_timer_fn()
768 if (ws->active && ws->timer_expires in pm_wakeup_timer_fn()
769 && time_after_eq(jiffies, ws->timer_expires)) { in pm_wakeup_timer_fn()
771 ws->expire_count++; in pm_wakeup_timer_fn()
774 spin_unlock_irqrestore(&ws->lock, flags); in pm_wakeup_timer_fn()
778 * pm_wakeup_ws_event - Notify the PM core of a wakeup event.
779 * @ws: Wakeup source object associated with the event source.
781 * @hard: If set, abort suspends in progress and wake up from suspend-to-idle.
783 * Notify the PM core of a wakeup event whose source is @ws that will take
798 spin_lock_irqsave(&ws->lock, flags); in pm_wakeup_ws_event()
811 if (!ws->timer_expires || time_after(expires, ws->timer_expires)) { in pm_wakeup_ws_event()
812 mod_timer(&ws->timer, expires); in pm_wakeup_ws_event()
813 ws->timer_expires = expires; in pm_wakeup_ws_event()
817 spin_unlock_irqrestore(&ws->lock, flags); in pm_wakeup_ws_event()
822 * pm_wakeup_dev_event - Notify the PM core of a wakeup event.
823 * @dev: Device the wakeup event is related to.
825 * @hard: If set, abort suspends in progress and wake up from suspend-to-idle.
827 * Call pm_wakeup_ws_event() for the @dev's wakeup source object.
836 spin_lock_irqsave(&dev->power.lock, flags); in pm_wakeup_dev_event()
837 pm_wakeup_ws_event(dev->power.wakeup, msec, hard); in pm_wakeup_dev_event()
838 spin_unlock_irqrestore(&dev->power.lock, flags); in pm_wakeup_dev_event()
850 if (ws->active) { in pm_print_active_wakeup_sources()
851 pm_pr_dbg("active wakeup source: %s\n", ws->name); in pm_print_active_wakeup_sources()
855 ktime_to_ns(ws->last_time) > in pm_print_active_wakeup_sources()
856 ktime_to_ns(last_activity_ws->last_time))) { in pm_print_active_wakeup_sources()
862 pm_pr_dbg("last active wakeup source: %s\n", in pm_print_active_wakeup_sources()
863 last_activity_ws->name); in pm_print_active_wakeup_sources()
869 * pm_wakeup_pending - Check if power transition in progress should be aborted.
871 * Compare the current number of registered wakeup events with its preserved
872 * value from the past and return true if new wakeup events have been registered
874 * wakeup events being processed is different from zero.
892 pm_pr_dbg("Wakeup pending, aborting suspend\n"); in pm_wakeup_pending()
942 pm_pr_dbg("Triggering wakeup from IRQ %d\n", irq_number); in pm_system_irq_wakeup()
956 * pm_get_wakeup_count - Read the number of registered wakeup events.
960 * Store the number of registered wakeup events at the address in @count. If
961 * @block is set, block until the current number of wakeup events being
964 * Return 'false' if the current number of wakeup events being processed is
992 * pm_save_wakeup_count - Save the current number of registered wakeup events.
993 * @count: Value to compare with the current number of registered wakeup events.
995 * If @count is equal to the current number of registered wakeup events and the
996 * current number of wakeup events being processed is zero, store @count as the
997 * old number of registered wakeup events for pm_check_wakeup_events(), enable
998 * wakeup events detection and return 'true'. Otherwise disable wakeup events
1019 * pm_wakep_autosleep_enabled - Modify autosleep_enabled for all wakeup sources.
1030 spin_lock_irq(&ws->lock); in pm_wakep_autosleep_enabled()
1031 if (ws->autosleep_enabled != set) { in pm_wakep_autosleep_enabled()
1032 ws->autosleep_enabled = set; in pm_wakep_autosleep_enabled()
1033 if (ws->active) { in pm_wakep_autosleep_enabled()
1035 ws->start_prevent_time = now; in pm_wakep_autosleep_enabled()
1040 spin_unlock_irq(&ws->lock); in pm_wakep_autosleep_enabled()
1047 * print_wakeup_source_stats - Print wakeup source statistics information.
1049 * @ws: Wakeup source object to print the statistics for.
1061 spin_lock_irqsave(&ws->lock, flags); in print_wakeup_source_stats()
1063 total_time = ws->total_time; in print_wakeup_source_stats()
1064 max_time = ws->max_time; in print_wakeup_source_stats()
1065 prevent_sleep_time = ws->prevent_sleep_time; in print_wakeup_source_stats()
1066 active_count = ws->active_count; in print_wakeup_source_stats()
1067 if (ws->active) { in print_wakeup_source_stats()
1070 active_time = ktime_sub(now, ws->last_time); in print_wakeup_source_stats()
1075 if (ws->autosleep_enabled) in print_wakeup_source_stats()
1077 ktime_sub(now, ws->start_prevent_time)); in print_wakeup_source_stats()
1082 seq_printf(m, "%-12s\t%lu\t\t%lu\t\t%lu\t\t%lu\t\t%lld\t\t%lld\t\t%lld\t\t%lld\t\t%lld\n", in print_wakeup_source_stats()
1083 ws->name, active_count, ws->event_count, in print_wakeup_source_stats()
1084 ws->wakeup_count, ws->expire_count, in print_wakeup_source_stats()
1086 ktime_to_ms(max_time), ktime_to_ms(ws->last_time), in print_wakeup_source_stats()
1089 spin_unlock_irqrestore(&ws->lock, flags); in print_wakeup_source_stats()
1099 int *srcuidx = m->private; in wakeup_sources_stats_seq_start()
1109 if (n-- <= 0) in wakeup_sources_stats_seq_start()
1137 int *srcuidx = m->private; in wakeup_sources_stats_seq_stop()
1143 * wakeup_sources_stats_seq_show - Print wakeup sources statistics information.