Lines Matching +full:wakeup +full:- +full:source
1 // SPDX-License-Identifier: GPL-2.0
3 * drivers/base/power/wakeup.c - System wakeup events framework
35 * if wakeup events are registered during or immediately before the transition.
39 /* First wakeup IRQ seen by the kernel in the last cycle. */
47 * Combined counters of registered wakeup events and wakeup events in progress.
54 #define MAX_IN_PROGRESS ((1 << IN_PROGRESS_BITS) - 1)
85 * wakeup_source_create - Create a struct wakeup_source object.
86 * @name: Name of the new wakeup source.
101 ws->name = ws_name; in wakeup_source_create()
106 ws->id = id; in wakeup_source_create()
111 kfree_const(ws->name); in wakeup_source_create()
128 if (ws->event_count) { in wakeup_source_record()
130 ktime_add(deleted_ws.total_time, ws->total_time); in wakeup_source_record()
133 ws->prevent_sleep_time); in wakeup_source_record()
135 ktime_compare(deleted_ws.max_time, ws->max_time) > 0 ? in wakeup_source_record()
136 deleted_ws.max_time : ws->max_time; in wakeup_source_record()
137 deleted_ws.event_count += ws->event_count; in wakeup_source_record()
138 deleted_ws.active_count += ws->active_count; in wakeup_source_record()
139 deleted_ws.relax_count += ws->relax_count; in wakeup_source_record()
140 deleted_ws.expire_count += ws->expire_count; in wakeup_source_record()
141 deleted_ws.wakeup_count += ws->wakeup_count; in wakeup_source_record()
149 ida_free(&wakeup_ida, ws->id); in wakeup_source_free()
150 kfree_const(ws->name); in wakeup_source_free()
155 * wakeup_source_destroy - Destroy a struct wakeup_source object.
156 * @ws: Wakeup source to destroy.
158 * Use only for wakeup source objects created with wakeup_source_create().
172 * wakeup_source_add - Add given object to the list of wakeup sources.
173 * @ws: Wakeup source object to add to the list.
182 spin_lock_init(&ws->lock); in wakeup_source_add()
183 timer_setup(&ws->timer, pm_wakeup_timer_fn, 0); in wakeup_source_add()
184 ws->active = false; in wakeup_source_add()
187 list_add_rcu(&ws->entry, &wakeup_sources); in wakeup_source_add()
193 * wakeup_source_remove - Remove given object from the wakeup sources list.
194 * @ws: Wakeup source object to remove from the list.
204 list_del_rcu(&ws->entry); in wakeup_source_remove()
208 del_timer_sync(&ws->timer); in wakeup_source_remove()
211 * this wakeup source as not registered. in wakeup_source_remove()
213 ws->timer.function = NULL; in wakeup_source_remove()
218 * wakeup_source_register - Create wakeup source and add it to the list.
219 * @dev: Device this wakeup source is associated with (or NULL if virtual).
220 * @name: Name of the wakeup source to register.
244 * wakeup_source_unregister - Remove wakeup source from the list and remove it.
245 * @ws: Wakeup source object to unregister.
251 if (ws->dev) in wakeup_source_unregister()
260 * wakeup_sources_read_lock - Lock wakeup source list for read.
272 * wakeup_sources_read_unlock - Unlock wakeup source list.
282 * wakeup_sources_walk_start - Begin a walk on wakeup source list
284 * Returns first object of the list of wakeup sources.
286 * Note that to be safe, wakeup sources list needs to be locked by calling
293 return list_entry_rcu(ws_head->next, struct wakeup_source, entry); in wakeup_sources_walk_start()
298 * wakeup_sources_walk_next - Get next wakeup source from the list
299 * @ws: Previous wakeup source object
301 * Note that to be safe, wakeup sources list needs to be locked by calling
308 return list_next_or_null_rcu(ws_head, &ws->entry, in wakeup_sources_walk_next()
314 * device_wakeup_attach - Attach a wakeup source object to a device object.
316 * @ws: Wakeup source object to attach to @dev.
318 * This causes @dev to be treated as a wakeup device.
322 spin_lock_irq(&dev->power.lock); in device_wakeup_attach()
323 if (dev->power.wakeup) { in device_wakeup_attach()
324 spin_unlock_irq(&dev->power.lock); in device_wakeup_attach()
325 return -EEXIST; in device_wakeup_attach()
327 dev->power.wakeup = ws; in device_wakeup_attach()
328 if (dev->power.wakeirq) in device_wakeup_attach()
329 device_wakeup_attach_irq(dev, dev->power.wakeirq); in device_wakeup_attach()
330 spin_unlock_irq(&dev->power.lock); in device_wakeup_attach()
335 * device_wakeup_enable - Enable given device to be a wakeup source.
338 * Create a wakeup source object, register it and attach it to @dev.
345 if (!dev || !dev->power.can_wakeup) in device_wakeup_enable()
346 return -EINVAL; in device_wakeup_enable()
353 return -ENOMEM; in device_wakeup_enable()
364 * device_wakeup_attach_irq - Attach a wakeirq to a wakeup source
368 * Attach a device wakeirq to the wakeup source so the device
379 ws = dev->power.wakeup; in device_wakeup_attach_irq()
383 if (ws->wakeirq) in device_wakeup_attach_irq()
384 dev_err(dev, "Leftover wakeup IRQ found, overriding\n"); in device_wakeup_attach_irq()
386 ws->wakeirq = wakeirq; in device_wakeup_attach_irq()
390 * device_wakeup_detach_irq - Detach a wakeirq from a wakeup source
393 * Removes a device wakeirq from the wakeup source.
401 ws = dev->power.wakeup; in device_wakeup_detach_irq()
403 ws->wakeirq = NULL; in device_wakeup_detach_irq()
418 dev_pm_arm_wake_irq(ws->wakeirq); in device_wakeup_arm_wake_irqs()
434 dev_pm_disarm_wake_irq(ws->wakeirq); in device_wakeup_disarm_wake_irqs()
439 * device_wakeup_detach - Detach a device's wakeup source object from it.
440 * @dev: Device to detach the wakeup source object from.
442 * After it returns, @dev will not be treated as a wakeup device any more.
448 spin_lock_irq(&dev->power.lock); in device_wakeup_detach()
449 ws = dev->power.wakeup; in device_wakeup_detach()
450 dev->power.wakeup = NULL; in device_wakeup_detach()
451 spin_unlock_irq(&dev->power.lock); in device_wakeup_detach()
456 * device_wakeup_disable - Do not regard a device as a wakeup source any more.
459 * Detach the @dev's wakeup source object from it, unregister this wakeup source
466 if (!dev || !dev->power.can_wakeup) in device_wakeup_disable()
467 return -EINVAL; in device_wakeup_disable()
476 * device_set_wakeup_capable - Set/reset device wakeup capability flag.
481 * wakeup-related attributes to sysfs. Otherwise, unset the @dev's
482 * power.can_wakeup flag and remove its wakeup-related attributes from sysfs.
489 if (!!dev->power.can_wakeup == !!capable) in device_set_wakeup_capable()
492 dev->power.can_wakeup = capable; in device_set_wakeup_capable()
493 if (device_is_registered(dev) && !list_empty(&dev->power.entry)) { in device_set_wakeup_capable()
498 dev_info(dev, "Wakeup sysfs attributes not added\n"); in device_set_wakeup_capable()
507 * device_init_wakeup - Device wakeup initialization.
509 * @enable: Whether or not to enable @dev as a wakeup device.
511 * By default, most devices should leave wakeup disabled. The exceptions are
512 * devices that everyone expects to be wakeup sources: keyboards, power buttons,
514 * own wakeup requests but merely forward requests from one bus to another
515 * (like PCI bridges) should have wakeup enabled by default.
522 return -EINVAL; in device_init_wakeup()
537 * device_set_wakeup_enable - Enable or disable a device to wake up the system.
547 * wakeup_source_not_registered - validate the given wakeup source.
548 * @ws: Wakeup source to be validated.
553 * Use timer struct to check if the given source is initialized in wakeup_source_not_registered()
556 return ws->timer.function != pm_wakeup_timer_fn; in wakeup_source_not_registered()
560 * The functions below use the observation that each wakeup event starts a
562 * will end depends on how the wakeup event is going to be processed after being
566 * First, a wakeup event may be detected by the same functional unit that will
574 * Second, a wakeup event may be detected by one functional unit and processed
588 * wakup_source_activate - Mark given wakeup source as active.
589 * @ws: Wakeup source to handle.
592 * core of the event by incrementing the counter of of wakeup events being
600 "unregistered wakeup source\n")) in wakeup_source_activate()
603 ws->active = true; in wakeup_source_activate()
604 ws->active_count++; in wakeup_source_activate()
605 ws->last_time = ktime_get(); in wakeup_source_activate()
606 if (ws->autosleep_enabled) in wakeup_source_activate()
607 ws->start_prevent_time = ws->last_time; in wakeup_source_activate()
612 trace_wakeup_source_activate(ws->name, cec); in wakeup_source_activate()
616 * wakeup_source_report_event - Report wakeup event using the given source.
617 * @ws: Wakeup source to report the event for.
618 * @hard: If set, abort suspends in progress and wake up from suspend-to-idle.
622 ws->event_count++; in wakeup_source_report_event()
625 ws->wakeup_count++; in wakeup_source_report_event()
627 if (!ws->active) in wakeup_source_report_event()
635 * __pm_stay_awake - Notify the PM core of a wakeup event.
636 * @ws: Wakeup source object associated with the source of the event.
647 spin_lock_irqsave(&ws->lock, flags); in __pm_stay_awake()
650 del_timer(&ws->timer); in __pm_stay_awake()
651 ws->timer_expires = 0; in __pm_stay_awake()
653 spin_unlock_irqrestore(&ws->lock, flags); in __pm_stay_awake()
658 * pm_stay_awake - Notify the PM core that a wakeup event is being processed.
659 * @dev: Device the wakeup event is related to.
661 * Notify the PM core of a wakeup event (signaled by @dev) by calling
662 * __pm_stay_awake for the @dev's wakeup source object.
664 * Call this function after detecting of a wakeup event if pm_relax() is going
675 spin_lock_irqsave(&dev->power.lock, flags); in pm_stay_awake()
676 __pm_stay_awake(dev->power.wakeup); in pm_stay_awake()
677 spin_unlock_irqrestore(&dev->power.lock, flags); in pm_stay_awake()
684 ktime_t delta = ktime_sub(now, ws->start_prevent_time); in update_prevent_sleep_time()
685 ws->prevent_sleep_time = ktime_add(ws->prevent_sleep_time, delta); in update_prevent_sleep_time()
693 * wakup_source_deactivate - Mark given wakeup source as inactive.
694 * @ws: Wakeup source to handle.
696 * Update the @ws' statistics and notify the PM core that the wakeup source has
697 * become inactive by decrementing the counter of wakeup events being processed
698 * and incrementing the counter of registered wakeup events.
706 ws->relax_count++; in wakeup_source_deactivate()
712 * will set ws->active. Then, ws->active may be cleared immediately in wakeup_source_deactivate()
714 * case ws->relax_count will be different from ws->active_count. in wakeup_source_deactivate()
716 if (ws->relax_count != ws->active_count) { in wakeup_source_deactivate()
717 ws->relax_count--; in wakeup_source_deactivate()
721 ws->active = false; in wakeup_source_deactivate()
724 duration = ktime_sub(now, ws->last_time); in wakeup_source_deactivate()
725 ws->total_time = ktime_add(ws->total_time, duration); in wakeup_source_deactivate()
726 if (ktime_to_ns(duration) > ktime_to_ns(ws->max_time)) in wakeup_source_deactivate()
727 ws->max_time = duration; in wakeup_source_deactivate()
729 ws->last_time = now; in wakeup_source_deactivate()
730 del_timer(&ws->timer); in wakeup_source_deactivate()
731 ws->timer_expires = 0; in wakeup_source_deactivate()
733 if (ws->autosleep_enabled) in wakeup_source_deactivate()
737 * Increment the counter of registered wakeup events and decrement the in wakeup_source_deactivate()
738 * couter of wakeup events in progress simultaneously. in wakeup_source_deactivate()
741 trace_wakeup_source_deactivate(ws->name, cec); in wakeup_source_deactivate()
749 * __pm_relax - Notify the PM core that processing of a wakeup event has ended.
750 * @ws: Wakeup source object associated with the source of the event.
752 * Call this function for wakeup events whose processing started with calling
764 spin_lock_irqsave(&ws->lock, flags); in __pm_relax()
765 if (ws->active) in __pm_relax()
767 spin_unlock_irqrestore(&ws->lock, flags); in __pm_relax()
772 * pm_relax - Notify the PM core that processing of a wakeup event has ended.
775 * Execute __pm_relax() for the @dev's wakeup source object.
784 spin_lock_irqsave(&dev->power.lock, flags); in pm_relax()
785 __pm_relax(dev->power.wakeup); in pm_relax()
786 spin_unlock_irqrestore(&dev->power.lock, flags); in pm_relax()
791 * pm_wakeup_timer_fn - Delayed finalization of a wakeup event.
792 * @data: Address of the wakeup source object associated with the event source.
794 * Call wakeup_source_deactivate() for the wakeup source whose address is stored
803 spin_lock_irqsave(&ws->lock, flags); in pm_wakeup_timer_fn()
805 if (ws->active && ws->timer_expires in pm_wakeup_timer_fn()
806 && time_after_eq(jiffies, ws->timer_expires)) { in pm_wakeup_timer_fn()
808 ws->expire_count++; in pm_wakeup_timer_fn()
811 spin_unlock_irqrestore(&ws->lock, flags); in pm_wakeup_timer_fn()
815 * pm_wakeup_ws_event - Notify the PM core of a wakeup event.
816 * @ws: Wakeup source object associated with the event source.
818 * @hard: If set, abort suspends in progress and wake up from suspend-to-idle.
820 * Notify the PM core of a wakeup event whose source is @ws that will take
835 spin_lock_irqsave(&ws->lock, flags); in pm_wakeup_ws_event()
848 if (!ws->timer_expires || time_after(expires, ws->timer_expires)) { in pm_wakeup_ws_event()
849 mod_timer(&ws->timer, expires); in pm_wakeup_ws_event()
850 ws->timer_expires = expires; in pm_wakeup_ws_event()
854 spin_unlock_irqrestore(&ws->lock, flags); in pm_wakeup_ws_event()
859 * pm_wakeup_dev_event - Notify the PM core of a wakeup event.
860 * @dev: Device the wakeup event is related to.
862 * @hard: If set, abort suspends in progress and wake up from suspend-to-idle.
864 * Call pm_wakeup_ws_event() for the @dev's wakeup source object.
873 spin_lock_irqsave(&dev->power.lock, flags); in pm_wakeup_dev_event()
874 pm_wakeup_ws_event(dev->power.wakeup, msec, hard); in pm_wakeup_dev_event()
875 spin_unlock_irqrestore(&dev->power.lock, flags); in pm_wakeup_dev_event()
887 if (ws->active && len < max) { in pm_get_active_wakeup_sources()
890 "Pending Wakeup Sources: "); in pm_get_active_wakeup_sources()
891 len += scnprintf(pending_wakeup_source + len, max - len, in pm_get_active_wakeup_sources()
892 "%s ", ws->name); in pm_get_active_wakeup_sources()
896 ktime_to_ns(ws->last_time) > in pm_get_active_wakeup_sources()
897 ktime_to_ns(last_active_ws->last_time))) { in pm_get_active_wakeup_sources()
903 "Last active Wakeup Source: %s", in pm_get_active_wakeup_sources()
904 last_active_ws->name); in pm_get_active_wakeup_sources()
918 if (ws->active) { in pm_print_active_wakeup_sources()
919 pm_pr_dbg("active wakeup source: %s\n", ws->name); in pm_print_active_wakeup_sources()
923 ktime_to_ns(ws->last_time) > in pm_print_active_wakeup_sources()
924 ktime_to_ns(last_activity_ws->last_time))) { in pm_print_active_wakeup_sources()
930 pm_pr_dbg("last active wakeup source: %s\n", in pm_print_active_wakeup_sources()
931 last_activity_ws->name); in pm_print_active_wakeup_sources()
937 * pm_wakeup_pending - Check if power transition in progress should be aborted.
939 * Compare the current number of registered wakeup events with its preserved
940 * value from the past and return true if new wakeup events have been registered
942 * wakeup events being processed is different from zero.
961 pm_pr_dbg("Wakeup pending, aborting suspend\n"); in pm_wakeup_pending()
1023 else if (desc->action && desc->action->name) in pm_system_irq_wakeup()
1024 name = desc->action->name; in pm_system_irq_wakeup()
1038 * pm_get_wakeup_count - Read the number of registered wakeup events.
1042 * Store the number of registered wakeup events at the address in @count. If
1043 * @block is set, block until the current number of wakeup events being
1046 * Return 'false' if the current number of wakeup events being processed is
1074 * pm_save_wakeup_count - Save the current number of registered wakeup events.
1075 * @count: Value to compare with the current number of registered wakeup events.
1077 * If @count is equal to the current number of registered wakeup events and the
1078 * current number of wakeup events being processed is zero, store @count as the
1079 * old number of registered wakeup events for pm_check_wakeup_events(), enable
1080 * wakeup events detection and return 'true'. Otherwise disable wakeup events
1101 * pm_wakep_autosleep_enabled - Modify autosleep_enabled for all wakeup sources.
1112 spin_lock_irq(&ws->lock); in pm_wakep_autosleep_enabled()
1113 if (ws->autosleep_enabled != set) { in pm_wakep_autosleep_enabled()
1114 ws->autosleep_enabled = set; in pm_wakep_autosleep_enabled()
1115 if (ws->active) { in pm_wakep_autosleep_enabled()
1117 ws->start_prevent_time = now; in pm_wakep_autosleep_enabled()
1122 spin_unlock_irq(&ws->lock); in pm_wakep_autosleep_enabled()
1129 * print_wakeup_source_stats - Print wakeup source statistics information.
1131 * @ws: Wakeup source object to print the statistics for.
1143 spin_lock_irqsave(&ws->lock, flags); in print_wakeup_source_stats()
1145 total_time = ws->total_time; in print_wakeup_source_stats()
1146 max_time = ws->max_time; in print_wakeup_source_stats()
1147 prevent_sleep_time = ws->prevent_sleep_time; in print_wakeup_source_stats()
1148 active_count = ws->active_count; in print_wakeup_source_stats()
1149 if (ws->active) { in print_wakeup_source_stats()
1152 active_time = ktime_sub(now, ws->last_time); in print_wakeup_source_stats()
1157 if (ws->autosleep_enabled) in print_wakeup_source_stats()
1159 ktime_sub(now, ws->start_prevent_time)); in print_wakeup_source_stats()
1164 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()
1165 ws->name, active_count, ws->event_count, in print_wakeup_source_stats()
1166 ws->wakeup_count, ws->expire_count, in print_wakeup_source_stats()
1168 ktime_to_ms(max_time), ktime_to_ms(ws->last_time), in print_wakeup_source_stats()
1171 spin_unlock_irqrestore(&ws->lock, flags); in print_wakeup_source_stats()
1181 int *srcuidx = m->private; in wakeup_sources_stats_seq_start()
1191 if (n-- <= 0) in wakeup_sources_stats_seq_start()
1219 int *srcuidx = m->private; in wakeup_sources_stats_seq_stop()
1225 * wakeup_sources_stats_seq_show - Print wakeup sources statistics information.