123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423 |
- /*
- * kernel/power/suspend.c - Suspend to RAM and standby functionality.
- *
- * Copyright (c) 2003 Patrick Mochel
- * Copyright (c) 2003 Open Source Development Lab
- * Copyright (c) 2009 Rafael J. Wysocki <rjw@sisk.pl>, Novell Inc.
- *
- * This file is released under the GPLv2.
- */
- #include <linux/string.h>
- #include <linux/delay.h>
- #include <linux/errno.h>
- #include <linux/init.h>
- #include <linux/console.h>
- #include <linux/cpu.h>
- #include <linux/syscalls.h>
- #include <linux/gfp.h>
- #include <linux/io.h>
- #include <linux/kernel.h>
- #include <linux/list.h>
- #include <linux/mm.h>
- #include <linux/slab.h>
- #include <linux/export.h>
- #include <linux/suspend.h>
- #include <linux/syscore_ops.h>
- #include <linux/rtc.h>
- #include <linux/ftrace.h>
- #include <trace/events/power.h>
- #include <linux/pm_qos.h>
- #include <linux/wakeup_reason.h>
- #include "power.h"
- struct pm_sleep_state pm_states[PM_SUSPEND_MAX] = {
- [PM_SUSPEND_FREEZE] = { .label = "freeze", .state = PM_SUSPEND_FREEZE },
- [PM_SUSPEND_STANDBY] = { .label = "standby", },
- [PM_SUSPEND_MEM] = { .label = "mem", },
- };
- static const struct platform_suspend_ops *suspend_ops;
- static struct pm_qos_request suspend_pm_qos;
- static bool need_suspend_ops(suspend_state_t state)
- {
- return !!(state > PM_SUSPEND_FREEZE);
- }
- static DECLARE_WAIT_QUEUE_HEAD(suspend_freeze_wait_head);
- static bool suspend_freeze_wake;
- static void freeze_begin(void)
- {
- suspend_freeze_wake = false;
- }
- static void freeze_enter(void)
- {
- wait_event(suspend_freeze_wait_head, suspend_freeze_wake);
- }
- void freeze_wake(void)
- {
- suspend_freeze_wake = true;
- wake_up(&suspend_freeze_wait_head);
- }
- EXPORT_SYMBOL_GPL(freeze_wake);
- static bool valid_state(suspend_state_t state)
- {
- /*
- * PM_SUSPEND_STANDBY and PM_SUSPEND_MEM states need low level
- * support and need to be valid to the low level
- * implementation, no valid callback implies that none are valid.
- */
- return suspend_ops && suspend_ops->valid && suspend_ops->valid(state);
- }
- /**
- * suspend_set_ops - Set the global suspend method table.
- * @ops: Suspend operations to use.
- */
- void suspend_set_ops(const struct platform_suspend_ops *ops)
- {
- suspend_state_t i;
- lock_system_sleep();
- suspend_ops = ops;
- for (i = PM_SUSPEND_STANDBY; i <= PM_SUSPEND_MEM; i++)
- pm_states[i].state = valid_state(i) ? i : 0;
- unlock_system_sleep();
- }
- EXPORT_SYMBOL_GPL(suspend_set_ops);
- /**
- * suspend_valid_only_mem - Generic memory-only valid callback.
- *
- * Platform drivers that implement mem suspend only and only need to check for
- * that in their .valid() callback can use this instead of rolling their own
- * .valid() callback.
- */
- int suspend_valid_only_mem(suspend_state_t state)
- {
- return state == PM_SUSPEND_MEM;
- }
- EXPORT_SYMBOL_GPL(suspend_valid_only_mem);
- static int suspend_test(int level)
- {
- #ifdef CONFIG_PM_DEBUG
- if (pm_test_level == level) {
- printk(KERN_INFO "suspend debug: Waiting for 5 seconds.\n");
- mdelay(5000);
- return 1;
- }
- #endif /* !CONFIG_PM_DEBUG */
- return 0;
- }
- /**
- * suspend_prepare - Prepare for entering system sleep state.
- *
- * Common code run for every system sleep state that can be entered (except for
- * hibernation). Run suspend notifiers, allocate the "suspend" console and
- * freeze processes.
- */
- static int suspend_prepare(suspend_state_t state)
- {
- int error;
- if (need_suspend_ops(state) && (!suspend_ops || !suspend_ops->enter))
- return -EPERM;
- pm_prepare_console();
- error = pm_notifier_call_chain(PM_SUSPEND_PREPARE);
- if (error)
- goto Finish;
- error = suspend_freeze_processes();
- if (!error)
- return 0;
- log_suspend_abort_reason("One or more tasks refusing to freeze");
- suspend_stats.failed_freeze++;
- dpm_save_failed_step(SUSPEND_FREEZE);
- Finish:
- pm_notifier_call_chain(PM_POST_SUSPEND);
- pm_restore_console();
- return error;
- }
- /* default implementation */
- void __attribute__ ((weak)) arch_suspend_disable_irqs(void)
- {
- local_irq_disable();
- }
- /* default implementation */
- void __attribute__ ((weak)) arch_suspend_enable_irqs(void)
- {
- local_irq_enable();
- }
- /**
- * suspend_enter - Make the system enter the given sleep state.
- * @state: System sleep state to enter.
- * @wakeup: Returns information that the sleep state should not be re-entered.
- *
- * This function should be called after devices have been suspended.
- */
- static int suspend_enter(suspend_state_t state, bool *wakeup)
- {
- char suspend_abort[MAX_SUSPEND_ABORT_LEN];
- int error, last_dev;
- if (need_suspend_ops(state) && suspend_ops->prepare) {
- error = suspend_ops->prepare();
- if (error)
- goto Platform_finish;
- }
- error = dpm_suspend_end(PMSG_SUSPEND);
- if (error) {
- last_dev = suspend_stats.last_failed_dev + REC_FAILED_NUM - 1;
- last_dev %= REC_FAILED_NUM;
- printk(KERN_ERR "PM: Some devices failed to power down\n");
- log_suspend_abort_reason("%s device failed to power down",
- suspend_stats.failed_devs[last_dev]);
- goto Platform_finish;
- }
- if (need_suspend_ops(state) && suspend_ops->prepare_late) {
- error = suspend_ops->prepare_late();
- if (error)
- goto Platform_wake;
- }
- /*
- * PM_SUSPEND_FREEZE equals
- * frozen processes + suspended devices + idle processors.
- * Thus we should invoke freeze_enter() soon after
- * all the devices are suspended.
- */
- if (state == PM_SUSPEND_FREEZE) {
- freeze_enter();
- goto Platform_wake;
- }
- if (suspend_test(TEST_PLATFORM))
- goto Platform_wake;
- error = disable_nonboot_cpus();
- if (error || suspend_test(TEST_CPUS)) {
- log_suspend_abort_reason("Disabling non-boot cpus failed");
- goto Enable_cpus;
- }
- arch_suspend_disable_irqs();
- BUG_ON(!irqs_disabled());
- error = syscore_suspend();
- if (!error) {
- *wakeup = pm_wakeup_pending();
- if (!(suspend_test(TEST_CORE) || *wakeup)) {
- error = suspend_ops->enter(state);
- events_check_enabled = false;
- } else if (*wakeup) {
- pm_get_active_wakeup_sources(suspend_abort,
- MAX_SUSPEND_ABORT_LEN);
- log_suspend_abort_reason(suspend_abort);
- error = -EBUSY;
- }
- syscore_resume();
- }
- arch_suspend_enable_irqs();
- BUG_ON(irqs_disabled());
- Enable_cpus:
- enable_nonboot_cpus();
- Platform_wake:
- if (need_suspend_ops(state) && suspend_ops->wake)
- suspend_ops->wake();
- dpm_resume_start(PMSG_RESUME);
- Platform_finish:
- if (need_suspend_ops(state) && suspend_ops->finish)
- suspend_ops->finish();
- return error;
- }
- /**
- * suspend_devices_and_enter - Suspend devices and enter system sleep state.
- * @state: System sleep state to enter.
- */
- int suspend_devices_and_enter(suspend_state_t state)
- {
- int error;
- bool wakeup = false;
- if (need_suspend_ops(state) && !suspend_ops)
- return -ENOSYS;
- trace_machine_suspend(state);
- if (need_suspend_ops(state) && suspend_ops->begin) {
- error = suspend_ops->begin(state);
- if (error)
- goto Close;
- }
- suspend_console();
- ftrace_stop();
- suspend_test_start();
- error = dpm_suspend_start(PMSG_SUSPEND);
- if (error) {
- pr_err("PM: Some devices failed to suspend, or early wake event detected\n");
- log_suspend_abort_reason("Some devices failed to suspend");
- goto Recover_platform;
- }
- suspend_test_finish("suspend devices");
- if (suspend_test(TEST_DEVICES))
- goto Recover_platform;
- do {
- error = suspend_enter(state, &wakeup);
- } while (!error && !wakeup && need_suspend_ops(state)
- && suspend_ops->suspend_again && suspend_ops->suspend_again());
- Resume_devices:
- suspend_test_start();
- dpm_resume_end(PMSG_RESUME);
- suspend_test_finish("resume devices");
- ftrace_start();
- resume_console();
- Close:
- if (need_suspend_ops(state) && suspend_ops->end)
- suspend_ops->end();
- trace_machine_suspend(PWR_EVENT_EXIT);
- return error;
- Recover_platform:
- if (need_suspend_ops(state) && suspend_ops->recover)
- suspend_ops->recover();
- goto Resume_devices;
- }
- /**
- * suspend_finish - Clean up before finishing the suspend sequence.
- *
- * Call platform code to clean up, restart processes, and free the console that
- * we've allocated. This routine is not called for hibernation.
- */
- static void suspend_finish(void)
- {
- suspend_thaw_processes();
- pm_notifier_call_chain(PM_POST_SUSPEND);
- pm_restore_console();
- }
- /**
- * enter_state - Do common work needed to enter system sleep state.
- * @state: System sleep state to enter.
- *
- * Make sure that no one else is trying to put the system into a sleep state.
- * Fail if that's not the case. Otherwise, prepare for system suspend, make the
- * system enter the given sleep state and clean up after wakeup.
- */
- static int enter_state(suspend_state_t state)
- {
- int error;
- if (state == PM_SUSPEND_FREEZE) {
- #ifdef CONFIG_PM_DEBUG
- if (pm_test_level != TEST_NONE && pm_test_level <= TEST_CPUS) {
- pr_warning("PM: Unsupported test mode for freeze state,"
- "please choose none/freezer/devices/platform.\n");
- return -EAGAIN;
- }
- #endif
- } else if (!valid_state(state)) {
- return -EINVAL;
- }
- if (!mutex_trylock(&pm_mutex))
- return -EBUSY;
- if (state == PM_SUSPEND_FREEZE)
- freeze_begin();
- printk(KERN_INFO "PM: Syncing filesystems ... ");
- sys_sync();
- printk("done.\n");
- pm_qos_add_request(&suspend_pm_qos, PM_QOS_CPU_DMA_LATENCY,
- PM_QOS_DEFAULT_VALUE);
- pm_qos_update_request(&suspend_pm_qos, 0);
- pr_debug("PM: Preparing system for %s sleep\n", pm_states[state].label);
- error = suspend_prepare(state);
- if (error)
- goto Unlock;
- if (suspend_test(TEST_FREEZER))
- goto Finish;
- pr_debug("PM: Entering %s sleep\n", pm_states[state].label);
- pm_restrict_gfp_mask();
- error = suspend_devices_and_enter(state);
- pm_restore_gfp_mask();
- Finish:
- pr_debug("PM: Finishing wakeup.\n");
- suspend_finish();
- Unlock:
- pm_qos_update_request(&suspend_pm_qos, PM_QOS_CPU_DMA_LATENCY);
- pm_qos_remove_request(&suspend_pm_qos);
- mutex_unlock(&pm_mutex);
- return error;
- }
- static void pm_suspend_marker(char *annotation)
- {
- struct timespec ts;
- struct rtc_time tm;
- getnstimeofday(&ts);
- rtc_time_to_tm(ts.tv_sec, &tm);
- pr_info("PM: suspend %s %d-%02d-%02d %02d:%02d:%02d.%09lu UTC\n",
- annotation, tm.tm_year + 1900, tm.tm_mon + 1, tm.tm_mday,
- tm.tm_hour, tm.tm_min, tm.tm_sec, ts.tv_nsec);
- }
- /**
- * pm_suspend - Externally visible function for suspending the system.
- * @state: System sleep state to enter.
- *
- * Check if the value of @state represents one of the supported states,
- * execute enter_state() and update system suspend statistics.
- */
- int pm_suspend(suspend_state_t state)
- {
- int error;
- if (state <= PM_SUSPEND_ON || state >= PM_SUSPEND_MAX)
- return -EINVAL;
- pm_suspend_marker("entry");
- error = enter_state(state);
- if (error) {
- suspend_stats.fail++;
- dpm_save_failed_errno(error);
- } else {
- suspend_stats.success++;
- }
- pm_suspend_marker("exit");
- return error;
- }
- EXPORT_SYMBOL(pm_suspend);
|