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.
86  * @name: Name of the new wakeup source.
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.
193  * wakeup_source_remove - Remove given object from the wakeup sources list.
194  * @ws: Wakeup source object to remove from the list.
211 	 * this wakeup source as not registered.  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.
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
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
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.
323 	if (dev->power.wakeup) {  in device_wakeup_attach()
327 	dev->power.wakeup = ws;  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.
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()
384 		dev_err(dev, "Leftover wakeup IRQ found, overriding\n");  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()
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.
449 	ws = dev->power.wakeup;  in device_wakeup_detach()
450 	dev->power.wakeup = NULL;  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
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.
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.
547  * wakeup_source_not_registered - validate the given wakeup source.
548  * @ws: Wakeup source to be validated.
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()
616  * wakeup_source_report_event - Report wakeup event using the given source.
617  * @ws: Wakeup source to report the event for.
635  * __pm_stay_awake - Notify the PM core of a wakeup event.
636  * @ws: Wakeup source object associated with the source of the event.
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
676 	__pm_stay_awake(dev->power.wakeup);  in pm_stay_awake()
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.
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()
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
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.
785 	__pm_relax(dev->power.wakeup);  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
815  * pm_wakeup_ws_event - Notify the PM core of a wakeup event.
816  * @ws: Wakeup source object associated with the event source.
820  * Notify the PM core of a wakeup event whose source is @ws that will take
859  * pm_wakeup_dev_event - Notify the PM core of a wakeup event.
860  * @dev: Device the wakeup event is related to.
864  * Call pm_wakeup_ws_event() for the @dev's wakeup source object.
874 	pm_wakeup_ws_event(dev->power.wakeup, msec, hard);  in pm_wakeup_dev_event()
890 						"Pending Wakeup Sources: ");  in pm_get_active_wakeup_sources()
903 				"Last active Wakeup Source: %s",  in pm_get_active_wakeup_sources()
919 			pm_pr_dbg("active wakeup source: %s\n", ws->name);  in pm_print_active_wakeup_sources()
930 		pm_pr_dbg("last active wakeup source: %s\n",  in pm_print_active_wakeup_sources()
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()
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.
1129  * print_wakeup_source_stats - Print wakeup source statistics information.
1131  * @ws: Wakeup source object to print the statistics for.
1225  * wakeup_sources_stats_seq_show - Print wakeup sources statistics information.