1// SPDX-License-Identifier: GPL-2.0-only
2/*
3 * sleep.c - ACPI sleep support.
4 *
5 * Copyright (c) 2005 Alexey Starikovskiy <alexey.y.starikovskiy@intel.com>
6 * Copyright (c) 2004 David Shaohua Li <shaohua.li@intel.com>
7 * Copyright (c) 2000-2003 Patrick Mochel
8 * Copyright (c) 2003 Open Source Development Lab
9 */
10
11#define pr_fmt(fmt) "ACPI: PM: " fmt
12
13#include <linux/delay.h>
14#include <linux/irq.h>
15#include <linux/dmi.h>
16#include <linux/device.h>
17#include <linux/interrupt.h>
18#include <linux/suspend.h>
19#include <linux/reboot.h>
20#include <linux/acpi.h>
21#include <linux/module.h>
22#include <linux/syscore_ops.h>
23#include <asm/io.h>
24#include <trace/events/power.h>
25
26#include "internal.h"
27#include "sleep.h"
28
29/*
30 * Some HW-full platforms do not have _S5, so they may need
31 * to leverage efi power off for a shutdown.
32 */
33bool acpi_no_s5;
34static u8 sleep_states[ACPI_S_STATE_COUNT];
35
36static void acpi_sleep_tts_switch(u32 acpi_state)
37{
38 acpi_status status;
39
40 status = acpi_execute_simple_method(NULL, method: "\\_TTS", arg: acpi_state);
41 if (ACPI_FAILURE(status) && status != AE_NOT_FOUND) {
42 /*
43 * OS can't evaluate the _TTS object correctly. Some warning
44 * message will be printed. But it won't break anything.
45 */
46 pr_notice("Failure in evaluating _TTS object\n");
47 }
48}
49
50static int tts_notify_reboot(struct notifier_block *this,
51 unsigned long code, void *x)
52{
53 acpi_sleep_tts_switch(ACPI_STATE_S5);
54 return NOTIFY_DONE;
55}
56
57static struct notifier_block tts_notifier = {
58 .notifier_call = tts_notify_reboot,
59 .next = NULL,
60 .priority = 0,
61};
62
63#ifndef acpi_skip_set_wakeup_address
64#define acpi_skip_set_wakeup_address() false
65#endif
66
67static int acpi_sleep_prepare(u32 acpi_state)
68{
69#ifdef CONFIG_ACPI_SLEEP
70 unsigned long acpi_wakeup_address;
71
72 /* do we have a wakeup address for S2 and S3? */
73 if (acpi_state == ACPI_STATE_S3 && !acpi_skip_set_wakeup_address()) {
74 acpi_wakeup_address = acpi_get_wakeup_address();
75 if (!acpi_wakeup_address)
76 return -EFAULT;
77 acpi_set_waking_vector(wakeup_address: acpi_wakeup_address);
78
79 }
80#endif
81 pr_info("Preparing to enter system sleep state S%d\n", acpi_state);
82 acpi_enable_wakeup_devices(sleep_state: acpi_state);
83 acpi_enter_sleep_state_prep(sleep_state: acpi_state);
84 return 0;
85}
86
87bool acpi_sleep_state_supported(u8 sleep_state)
88{
89 acpi_status status;
90 u8 type_a, type_b;
91
92 status = acpi_get_sleep_type_data(sleep_state, slp_typ_a: &type_a, slp_typ_b: &type_b);
93 return ACPI_SUCCESS(status) && (!acpi_gbl_reduced_hardware
94 || (acpi_gbl_FADT.sleep_control.address
95 && acpi_gbl_FADT.sleep_status.address));
96}
97
98#ifdef CONFIG_ACPI_SLEEP
99static u32 acpi_target_sleep_state = ACPI_STATE_S0;
100
101u32 acpi_target_system_state(void)
102{
103 return acpi_target_sleep_state;
104}
105EXPORT_SYMBOL_GPL(acpi_target_system_state);
106
107static bool pwr_btn_event_pending;
108
109/*
110 * The ACPI specification wants us to save NVS memory regions during hibernation
111 * and to restore them during the subsequent resume. Windows does that also for
112 * suspend to RAM. However, it is known that this mechanism does not work on
113 * all machines, so we allow the user to disable it with the help of the
114 * 'acpi_sleep=nonvs' kernel command line option.
115 */
116static bool nvs_nosave;
117
118void __init acpi_nvs_nosave(void)
119{
120 nvs_nosave = true;
121}
122
123/*
124 * The ACPI specification wants us to save NVS memory regions during hibernation
125 * but says nothing about saving NVS during S3. Not all versions of Windows
126 * save NVS on S3 suspend either, and it is clear that not all systems need
127 * NVS to be saved at S3 time. To improve suspend/resume time, allow the
128 * user to disable saving NVS on S3 if their system does not require it, but
129 * continue to save/restore NVS for S4 as specified.
130 */
131static bool nvs_nosave_s3;
132
133void __init acpi_nvs_nosave_s3(void)
134{
135 nvs_nosave_s3 = true;
136}
137
138static int __init init_nvs_save_s3(const struct dmi_system_id *d)
139{
140 nvs_nosave_s3 = false;
141 return 0;
142}
143
144/*
145 * ACPI 1.0 wants us to execute _PTS before suspending devices, so we allow the
146 * user to request that behavior by using the 'acpi_old_suspend_ordering'
147 * kernel command line option that causes the following variable to be set.
148 */
149static bool old_suspend_ordering;
150
151void __init acpi_old_suspend_ordering(void)
152{
153 old_suspend_ordering = true;
154}
155
156static int __init init_old_suspend_ordering(const struct dmi_system_id *d)
157{
158 acpi_old_suspend_ordering();
159 return 0;
160}
161
162static int __init init_nvs_nosave(const struct dmi_system_id *d)
163{
164 acpi_nvs_nosave();
165 return 0;
166}
167
168bool acpi_sleep_default_s3;
169
170static int __init init_default_s3(const struct dmi_system_id *d)
171{
172 acpi_sleep_default_s3 = true;
173 return 0;
174}
175
176static const struct dmi_system_id acpisleep_dmi_table[] __initconst = {
177 {
178 .callback = init_old_suspend_ordering,
179 .ident = "Abit KN9 (nForce4 variant)",
180 .matches = {
181 DMI_MATCH(DMI_BOARD_VENDOR, "http://www.abit.com.tw/"),
182 DMI_MATCH(DMI_BOARD_NAME, "KN9 Series(NF-CK804)"),
183 },
184 },
185 {
186 .callback = init_old_suspend_ordering,
187 .ident = "HP xw4600 Workstation",
188 .matches = {
189 DMI_MATCH(DMI_SYS_VENDOR, "Hewlett-Packard"),
190 DMI_MATCH(DMI_PRODUCT_NAME, "HP xw4600 Workstation"),
191 },
192 },
193 {
194 .callback = init_old_suspend_ordering,
195 .ident = "Asus Pundit P1-AH2 (M2N8L motherboard)",
196 .matches = {
197 DMI_MATCH(DMI_BOARD_VENDOR, "ASUSTek Computer INC."),
198 DMI_MATCH(DMI_BOARD_NAME, "M2N8L"),
199 },
200 },
201 {
202 .callback = init_old_suspend_ordering,
203 .ident = "Panasonic CF51-2L",
204 .matches = {
205 DMI_MATCH(DMI_BOARD_VENDOR,
206 "Matsushita Electric Industrial Co.,Ltd."),
207 DMI_MATCH(DMI_BOARD_NAME, "CF51-2L"),
208 },
209 },
210 {
211 .callback = init_nvs_nosave,
212 .ident = "Sony Vaio VGN-FW41E_H",
213 .matches = {
214 DMI_MATCH(DMI_SYS_VENDOR, "Sony Corporation"),
215 DMI_MATCH(DMI_PRODUCT_NAME, "VGN-FW41E_H"),
216 },
217 },
218 {
219 .callback = init_nvs_nosave,
220 .ident = "Sony Vaio VGN-FW21E",
221 .matches = {
222 DMI_MATCH(DMI_SYS_VENDOR, "Sony Corporation"),
223 DMI_MATCH(DMI_PRODUCT_NAME, "VGN-FW21E"),
224 },
225 },
226 {
227 .callback = init_nvs_nosave,
228 .ident = "Sony Vaio VGN-FW21M",
229 .matches = {
230 DMI_MATCH(DMI_SYS_VENDOR, "Sony Corporation"),
231 DMI_MATCH(DMI_PRODUCT_NAME, "VGN-FW21M"),
232 },
233 },
234 {
235 .callback = init_nvs_nosave,
236 .ident = "Sony Vaio VPCEB17FX",
237 .matches = {
238 DMI_MATCH(DMI_SYS_VENDOR, "Sony Corporation"),
239 DMI_MATCH(DMI_PRODUCT_NAME, "VPCEB17FX"),
240 },
241 },
242 {
243 .callback = init_nvs_nosave,
244 .ident = "Sony Vaio VGN-SR11M",
245 .matches = {
246 DMI_MATCH(DMI_SYS_VENDOR, "Sony Corporation"),
247 DMI_MATCH(DMI_PRODUCT_NAME, "VGN-SR11M"),
248 },
249 },
250 {
251 .callback = init_nvs_nosave,
252 .ident = "Everex StepNote Series",
253 .matches = {
254 DMI_MATCH(DMI_SYS_VENDOR, "Everex Systems, Inc."),
255 DMI_MATCH(DMI_PRODUCT_NAME, "Everex StepNote Series"),
256 },
257 },
258 {
259 .callback = init_nvs_nosave,
260 .ident = "Sony Vaio VPCEB1Z1E",
261 .matches = {
262 DMI_MATCH(DMI_SYS_VENDOR, "Sony Corporation"),
263 DMI_MATCH(DMI_PRODUCT_NAME, "VPCEB1Z1E"),
264 },
265 },
266 {
267 .callback = init_nvs_nosave,
268 .ident = "Sony Vaio VGN-NW130D",
269 .matches = {
270 DMI_MATCH(DMI_SYS_VENDOR, "Sony Corporation"),
271 DMI_MATCH(DMI_PRODUCT_NAME, "VGN-NW130D"),
272 },
273 },
274 {
275 .callback = init_nvs_nosave,
276 .ident = "Sony Vaio VPCCW29FX",
277 .matches = {
278 DMI_MATCH(DMI_SYS_VENDOR, "Sony Corporation"),
279 DMI_MATCH(DMI_PRODUCT_NAME, "VPCCW29FX"),
280 },
281 },
282 {
283 .callback = init_nvs_nosave,
284 .ident = "Averatec AV1020-ED2",
285 .matches = {
286 DMI_MATCH(DMI_SYS_VENDOR, "AVERATEC"),
287 DMI_MATCH(DMI_PRODUCT_NAME, "1000 Series"),
288 },
289 },
290 {
291 .callback = init_old_suspend_ordering,
292 .ident = "Asus A8N-SLI DELUXE",
293 .matches = {
294 DMI_MATCH(DMI_BOARD_VENDOR, "ASUSTeK Computer INC."),
295 DMI_MATCH(DMI_BOARD_NAME, "A8N-SLI DELUXE"),
296 },
297 },
298 {
299 .callback = init_old_suspend_ordering,
300 .ident = "Asus A8N-SLI Premium",
301 .matches = {
302 DMI_MATCH(DMI_BOARD_VENDOR, "ASUSTeK Computer INC."),
303 DMI_MATCH(DMI_BOARD_NAME, "A8N-SLI Premium"),
304 },
305 },
306 {
307 .callback = init_nvs_nosave,
308 .ident = "Sony Vaio VGN-SR26GN_P",
309 .matches = {
310 DMI_MATCH(DMI_SYS_VENDOR, "Sony Corporation"),
311 DMI_MATCH(DMI_PRODUCT_NAME, "VGN-SR26GN_P"),
312 },
313 },
314 {
315 .callback = init_nvs_nosave,
316 .ident = "Sony Vaio VPCEB1S1E",
317 .matches = {
318 DMI_MATCH(DMI_SYS_VENDOR, "Sony Corporation"),
319 DMI_MATCH(DMI_PRODUCT_NAME, "VPCEB1S1E"),
320 },
321 },
322 {
323 .callback = init_nvs_nosave,
324 .ident = "Sony Vaio VGN-FW520F",
325 .matches = {
326 DMI_MATCH(DMI_SYS_VENDOR, "Sony Corporation"),
327 DMI_MATCH(DMI_PRODUCT_NAME, "VGN-FW520F"),
328 },
329 },
330 {
331 .callback = init_nvs_nosave,
332 .ident = "Asus K54C",
333 .matches = {
334 DMI_MATCH(DMI_SYS_VENDOR, "ASUSTeK Computer Inc."),
335 DMI_MATCH(DMI_PRODUCT_NAME, "K54C"),
336 },
337 },
338 {
339 .callback = init_nvs_nosave,
340 .ident = "Asus K54HR",
341 .matches = {
342 DMI_MATCH(DMI_SYS_VENDOR, "ASUSTeK Computer Inc."),
343 DMI_MATCH(DMI_PRODUCT_NAME, "K54HR"),
344 },
345 },
346 {
347 .callback = init_nvs_save_s3,
348 .ident = "Asus 1025C",
349 .matches = {
350 DMI_MATCH(DMI_SYS_VENDOR, "ASUSTeK COMPUTER INC."),
351 DMI_MATCH(DMI_PRODUCT_NAME, "1025C"),
352 },
353 },
354 /*
355 * https://bugzilla.kernel.org/show_bug.cgi?id=189431
356 * Lenovo G50-45 is a platform later than 2012, but needs nvs memory
357 * saving during S3.
358 */
359 {
360 .callback = init_nvs_save_s3,
361 .ident = "Lenovo G50-45",
362 .matches = {
363 DMI_MATCH(DMI_SYS_VENDOR, "LENOVO"),
364 DMI_MATCH(DMI_PRODUCT_NAME, "80E3"),
365 },
366 },
367 {
368 .callback = init_nvs_save_s3,
369 .ident = "Lenovo G40-45",
370 .matches = {
371 DMI_MATCH(DMI_SYS_VENDOR, "LENOVO"),
372 DMI_MATCH(DMI_PRODUCT_NAME, "80E1"),
373 },
374 },
375 /*
376 * ThinkPad X1 Tablet(2016) cannot do suspend-to-idle using
377 * the Low Power S0 Idle firmware interface (see
378 * https://bugzilla.kernel.org/show_bug.cgi?id=199057).
379 */
380 {
381 .callback = init_default_s3,
382 .ident = "ThinkPad X1 Tablet(2016)",
383 .matches = {
384 DMI_MATCH(DMI_SYS_VENDOR, "LENOVO"),
385 DMI_MATCH(DMI_PRODUCT_NAME, "20GGA00L00"),
386 },
387 },
388 /*
389 * ASUS B1400CEAE hangs on resume from suspend (see
390 * https://bugzilla.kernel.org/show_bug.cgi?id=215742).
391 */
392 {
393 .callback = init_default_s3,
394 .ident = "ASUS B1400CEAE",
395 .matches = {
396 DMI_MATCH(DMI_SYS_VENDOR, "ASUSTeK COMPUTER INC."),
397 DMI_MATCH(DMI_PRODUCT_NAME, "ASUS EXPERTBOOK B1400CEAE"),
398 },
399 },
400 {},
401};
402
403static bool ignore_blacklist;
404
405void __init acpi_sleep_no_blacklist(void)
406{
407 ignore_blacklist = true;
408}
409
410static void __init acpi_sleep_dmi_check(void)
411{
412 if (ignore_blacklist)
413 return;
414
415 if (dmi_get_bios_year() >= 2012)
416 acpi_nvs_nosave_s3();
417
418 dmi_check_system(list: acpisleep_dmi_table);
419}
420
421/**
422 * acpi_pm_freeze - Disable the GPEs and suspend EC transactions.
423 */
424static int acpi_pm_freeze(void)
425{
426 acpi_disable_all_gpes();
427 acpi_os_wait_events_complete();
428 acpi_ec_block_transactions();
429 return 0;
430}
431
432/**
433 * acpi_pm_pre_suspend - Enable wakeup devices, "freeze" EC and save NVS.
434 */
435static int acpi_pm_pre_suspend(void)
436{
437 acpi_pm_freeze();
438 return suspend_nvs_save();
439}
440
441/**
442 * __acpi_pm_prepare - Prepare the platform to enter the target state.
443 *
444 * If necessary, set the firmware waking vector and do arch-specific
445 * nastiness to get the wakeup code to the waking vector.
446 */
447static int __acpi_pm_prepare(void)
448{
449 int error = acpi_sleep_prepare(acpi_state: acpi_target_sleep_state);
450 if (error)
451 acpi_target_sleep_state = ACPI_STATE_S0;
452
453 return error;
454}
455
456/**
457 * acpi_pm_prepare - Prepare the platform to enter the target sleep
458 * state and disable the GPEs.
459 */
460static int acpi_pm_prepare(void)
461{
462 int error = __acpi_pm_prepare();
463 if (!error)
464 error = acpi_pm_pre_suspend();
465
466 return error;
467}
468
469/**
470 * acpi_pm_finish - Instruct the platform to leave a sleep state.
471 *
472 * This is called after we wake back up (or if entering the sleep state
473 * failed).
474 */
475static void acpi_pm_finish(void)
476{
477 struct acpi_device *pwr_btn_adev;
478 u32 acpi_state = acpi_target_sleep_state;
479
480 acpi_ec_unblock_transactions();
481 suspend_nvs_free();
482
483 if (acpi_state == ACPI_STATE_S0)
484 return;
485
486 pr_info("Waking up from system sleep state S%d\n", acpi_state);
487 acpi_disable_wakeup_devices(sleep_state: acpi_state);
488 acpi_leave_sleep_state(sleep_state: acpi_state);
489
490 /* reset firmware waking vector */
491 acpi_set_waking_vector(wakeup_address: 0);
492
493 acpi_target_sleep_state = ACPI_STATE_S0;
494
495 acpi_resume_power_resources();
496
497 /* If we were woken with the fixed power button, provide a small
498 * hint to userspace in the form of a wakeup event on the fixed power
499 * button device (if it can be found).
500 *
501 * We delay the event generation til now, as the PM layer requires
502 * timekeeping to be running before we generate events. */
503 if (!pwr_btn_event_pending)
504 return;
505
506 pwr_btn_event_pending = false;
507 pwr_btn_adev = acpi_dev_get_first_match_dev(ACPI_BUTTON_HID_POWERF,
508 NULL, hrv: -1);
509 if (pwr_btn_adev) {
510 pm_wakeup_event(dev: &pwr_btn_adev->dev, msec: 0);
511 acpi_dev_put(adev: pwr_btn_adev);
512 }
513}
514
515/**
516 * acpi_pm_start - Start system PM transition.
517 */
518static void acpi_pm_start(u32 acpi_state)
519{
520 acpi_target_sleep_state = acpi_state;
521 acpi_sleep_tts_switch(acpi_state: acpi_target_sleep_state);
522 acpi_scan_lock_acquire();
523}
524
525/**
526 * acpi_pm_end - Finish up system PM transition.
527 */
528static void acpi_pm_end(void)
529{
530 acpi_turn_off_unused_power_resources();
531 acpi_scan_lock_release();
532 /*
533 * This is necessary in case acpi_pm_finish() is not called during a
534 * failing transition to a sleep state.
535 */
536 acpi_target_sleep_state = ACPI_STATE_S0;
537 acpi_sleep_tts_switch(acpi_state: acpi_target_sleep_state);
538}
539#else /* !CONFIG_ACPI_SLEEP */
540#define sleep_no_lps0 (1)
541#define acpi_target_sleep_state ACPI_STATE_S0
542#define acpi_sleep_default_s3 (1)
543static inline void acpi_sleep_dmi_check(void) {}
544#endif /* CONFIG_ACPI_SLEEP */
545
546#ifdef CONFIG_SUSPEND
547static u32 acpi_suspend_states[] = {
548 [PM_SUSPEND_ON] = ACPI_STATE_S0,
549 [PM_SUSPEND_STANDBY] = ACPI_STATE_S1,
550 [PM_SUSPEND_MEM] = ACPI_STATE_S3,
551 [PM_SUSPEND_MAX] = ACPI_STATE_S5
552};
553
554/**
555 * acpi_suspend_begin - Set the target system sleep state to the state
556 * associated with given @pm_state, if supported.
557 */
558static int acpi_suspend_begin(suspend_state_t pm_state)
559{
560 u32 acpi_state = acpi_suspend_states[pm_state];
561 int error;
562
563 error = (nvs_nosave || nvs_nosave_s3) ? 0 : suspend_nvs_alloc();
564 if (error)
565 return error;
566
567 if (!sleep_states[acpi_state]) {
568 pr_err("ACPI does not support sleep state S%u\n", acpi_state);
569 return -ENOSYS;
570 }
571 if (acpi_state > ACPI_STATE_S1)
572 pm_set_suspend_via_firmware();
573
574 acpi_pm_start(acpi_state);
575 return 0;
576}
577
578/**
579 * acpi_suspend_enter - Actually enter a sleep state.
580 * @pm_state: ignored
581 *
582 * Flush caches and go to sleep. For STR we have to call arch-specific
583 * assembly, which in turn call acpi_enter_sleep_state().
584 * It's unfortunate, but it works. Please fix if you're feeling frisky.
585 */
586static int acpi_suspend_enter(suspend_state_t pm_state)
587{
588 acpi_status status = AE_OK;
589 u32 acpi_state = acpi_target_sleep_state;
590 int error;
591
592 trace_suspend_resume(TPS("acpi_suspend"), val: acpi_state, start: true);
593 switch (acpi_state) {
594 case ACPI_STATE_S1:
595 barrier();
596 status = acpi_enter_sleep_state(sleep_state: acpi_state);
597 break;
598
599 case ACPI_STATE_S3:
600 if (!acpi_suspend_lowlevel)
601 return -ENOSYS;
602 error = acpi_suspend_lowlevel();
603 if (error)
604 return error;
605 pr_info("Low-level resume complete\n");
606 pm_set_resume_via_firmware();
607 break;
608 }
609 trace_suspend_resume(TPS("acpi_suspend"), val: acpi_state, start: false);
610
611 /* This violates the spec but is required for bug compatibility. */
612 acpi_write_bit_register(ACPI_BITREG_SCI_ENABLE, value: 1);
613
614 /* Reprogram control registers */
615 acpi_leave_sleep_state_prep(sleep_state: acpi_state);
616
617 /* ACPI 3.0 specs (P62) says that it's the responsibility
618 * of the OSPM to clear the status bit [ implying that the
619 * POWER_BUTTON event should not reach userspace ]
620 *
621 * However, we do generate a small hint for userspace in the form of
622 * a wakeup event. We flag this condition for now and generate the
623 * event later, as we're currently too early in resume to be able to
624 * generate wakeup events.
625 */
626 if (ACPI_SUCCESS(status) && (acpi_state == ACPI_STATE_S3)) {
627 acpi_event_status pwr_btn_status = ACPI_EVENT_FLAG_DISABLED;
628
629 acpi_get_event_status(ACPI_EVENT_POWER_BUTTON, event_status: &pwr_btn_status);
630
631 if (pwr_btn_status & ACPI_EVENT_FLAG_STATUS_SET) {
632 acpi_clear_event(ACPI_EVENT_POWER_BUTTON);
633 /* Flag for later */
634 pwr_btn_event_pending = true;
635 }
636 }
637
638 /*
639 * Disable all GPE and clear their status bits before interrupts are
640 * enabled. Some GPEs (like wakeup GPEs) have no handlers and this can
641 * prevent them from producing spurious interrups.
642 *
643 * acpi_leave_sleep_state() will reenable specific GPEs later.
644 *
645 * Because this code runs on one CPU with disabled interrupts (all of
646 * the other CPUs are offline at this time), it need not acquire any
647 * sleeping locks which may trigger an implicit preemption point even
648 * if there is no contention, so avoid doing that by using a low-level
649 * library routine here.
650 */
651 acpi_hw_disable_all_gpes();
652 /* Allow EC transactions to happen. */
653 acpi_ec_unblock_transactions();
654
655 suspend_nvs_restore();
656
657 return ACPI_SUCCESS(status) ? 0 : -EFAULT;
658}
659
660static int acpi_suspend_state_valid(suspend_state_t pm_state)
661{
662 u32 acpi_state;
663
664 switch (pm_state) {
665 case PM_SUSPEND_ON:
666 case PM_SUSPEND_STANDBY:
667 case PM_SUSPEND_MEM:
668 acpi_state = acpi_suspend_states[pm_state];
669
670 return sleep_states[acpi_state];
671 default:
672 return 0;
673 }
674}
675
676static const struct platform_suspend_ops acpi_suspend_ops = {
677 .valid = acpi_suspend_state_valid,
678 .begin = acpi_suspend_begin,
679 .prepare_late = acpi_pm_prepare,
680 .enter = acpi_suspend_enter,
681 .wake = acpi_pm_finish,
682 .end = acpi_pm_end,
683};
684
685/**
686 * acpi_suspend_begin_old - Set the target system sleep state to the
687 * state associated with given @pm_state, if supported, and
688 * execute the _PTS control method. This function is used if the
689 * pre-ACPI 2.0 suspend ordering has been requested.
690 */
691static int acpi_suspend_begin_old(suspend_state_t pm_state)
692{
693 int error = acpi_suspend_begin(pm_state);
694 if (!error)
695 error = __acpi_pm_prepare();
696
697 return error;
698}
699
700/*
701 * The following callbacks are used if the pre-ACPI 2.0 suspend ordering has
702 * been requested.
703 */
704static const struct platform_suspend_ops acpi_suspend_ops_old = {
705 .valid = acpi_suspend_state_valid,
706 .begin = acpi_suspend_begin_old,
707 .prepare_late = acpi_pm_pre_suspend,
708 .enter = acpi_suspend_enter,
709 .wake = acpi_pm_finish,
710 .end = acpi_pm_end,
711 .recover = acpi_pm_finish,
712};
713
714static bool s2idle_wakeup;
715
716int acpi_s2idle_begin(void)
717{
718 acpi_scan_lock_acquire();
719 return 0;
720}
721
722int acpi_s2idle_prepare(void)
723{
724 if (acpi_sci_irq_valid()) {
725 int error;
726
727 error = enable_irq_wake(irq: acpi_sci_irq);
728 if (error)
729 pr_warn("Warning: Failed to enable wakeup from IRQ %d: %d\n",
730 acpi_sci_irq, error);
731
732 acpi_ec_set_gpe_wake_mask(ACPI_GPE_ENABLE);
733 }
734
735 acpi_enable_wakeup_devices(ACPI_STATE_S0);
736
737 /* Change the configuration of GPEs to avoid spurious wakeup. */
738 acpi_enable_all_wakeup_gpes();
739 acpi_os_wait_events_complete();
740
741 s2idle_wakeup = true;
742 return 0;
743}
744
745bool acpi_s2idle_wake(void)
746{
747 if (!acpi_sci_irq_valid())
748 return pm_wakeup_pending();
749
750 while (pm_wakeup_pending()) {
751 /*
752 * If IRQD_WAKEUP_ARMED is set for the SCI at this point, the
753 * SCI has not triggered while suspended, so bail out (the
754 * wakeup is pending anyway and the SCI is not the source of
755 * it).
756 */
757 if (irqd_is_wakeup_armed(d: irq_get_irq_data(irq: acpi_sci_irq))) {
758 pm_pr_dbg("Wakeup unrelated to ACPI SCI\n");
759 return true;
760 }
761
762 /*
763 * If the status bit of any enabled fixed event is set, the
764 * wakeup is regarded as valid.
765 */
766 if (acpi_any_fixed_event_status_set()) {
767 pm_pr_dbg("ACPI fixed event wakeup\n");
768 return true;
769 }
770
771 /* Check wakeups from drivers sharing the SCI. */
772 if (acpi_check_wakeup_handlers()) {
773 pm_pr_dbg("ACPI custom handler wakeup\n");
774 return true;
775 }
776
777 /*
778 * Check non-EC GPE wakeups and if there are none, cancel the
779 * SCI-related wakeup and dispatch the EC GPE.
780 */
781 if (acpi_ec_dispatch_gpe()) {
782 pm_pr_dbg("ACPI non-EC GPE wakeup\n");
783 return true;
784 }
785
786 acpi_os_wait_events_complete();
787
788 /*
789 * The SCI is in the "suspended" state now and it cannot produce
790 * new wakeup events till the rearming below, so if any of them
791 * are pending here, they must be resulting from the processing
792 * of EC events above or coming from somewhere else.
793 */
794 if (pm_wakeup_pending()) {
795 pm_pr_dbg("Wakeup after ACPI Notify sync\n");
796 return true;
797 }
798
799 pm_pr_dbg("Rearming ACPI SCI for wakeup\n");
800
801 pm_wakeup_clear(irq_number: acpi_sci_irq);
802 rearm_wake_irq(irq: acpi_sci_irq);
803 }
804
805 return false;
806}
807
808void acpi_s2idle_restore(void)
809{
810 /*
811 * Drain pending events before restoring the working-state configuration
812 * of GPEs.
813 */
814 acpi_os_wait_events_complete(); /* synchronize GPE processing */
815 acpi_ec_flush_work(); /* flush the EC driver's workqueues */
816 acpi_os_wait_events_complete(); /* synchronize Notify handling */
817
818 s2idle_wakeup = false;
819
820 acpi_enable_all_runtime_gpes();
821
822 acpi_disable_wakeup_devices(ACPI_STATE_S0);
823
824 if (acpi_sci_irq_valid()) {
825 acpi_ec_set_gpe_wake_mask(ACPI_GPE_DISABLE);
826 disable_irq_wake(irq: acpi_sci_irq);
827 }
828}
829
830void acpi_s2idle_end(void)
831{
832 acpi_scan_lock_release();
833}
834
835static const struct platform_s2idle_ops acpi_s2idle_ops = {
836 .begin = acpi_s2idle_begin,
837 .prepare = acpi_s2idle_prepare,
838 .wake = acpi_s2idle_wake,
839 .restore = acpi_s2idle_restore,
840 .end = acpi_s2idle_end,
841};
842
843void __weak acpi_s2idle_setup(void)
844{
845 if (acpi_gbl_FADT.flags & ACPI_FADT_LOW_POWER_S0)
846 pr_info("Efficient low-power S0 idle declared\n");
847
848 s2idle_set_ops(ops: &acpi_s2idle_ops);
849}
850
851static void __init acpi_sleep_suspend_setup(void)
852{
853 bool suspend_ops_needed = false;
854 int i;
855
856 for (i = ACPI_STATE_S1; i < ACPI_STATE_S4; i++)
857 if (acpi_sleep_state_supported(sleep_state: i)) {
858 sleep_states[i] = 1;
859 suspend_ops_needed = true;
860 }
861
862 if (suspend_ops_needed)
863 suspend_set_ops(ops: old_suspend_ordering ?
864 &acpi_suspend_ops_old : &acpi_suspend_ops);
865
866 acpi_s2idle_setup();
867}
868
869#else /* !CONFIG_SUSPEND */
870#define s2idle_wakeup (false)
871static inline void acpi_sleep_suspend_setup(void) {}
872#endif /* !CONFIG_SUSPEND */
873
874bool acpi_s2idle_wakeup(void)
875{
876 return s2idle_wakeup;
877}
878
879#ifdef CONFIG_PM_SLEEP
880static u32 saved_bm_rld;
881
882static int acpi_save_bm_rld(void)
883{
884 acpi_read_bit_register(ACPI_BITREG_BUS_MASTER_RLD, return_value: &saved_bm_rld);
885 return 0;
886}
887
888static void acpi_restore_bm_rld(void)
889{
890 u32 resumed_bm_rld = 0;
891
892 acpi_read_bit_register(ACPI_BITREG_BUS_MASTER_RLD, return_value: &resumed_bm_rld);
893 if (resumed_bm_rld == saved_bm_rld)
894 return;
895
896 acpi_write_bit_register(ACPI_BITREG_BUS_MASTER_RLD, value: saved_bm_rld);
897}
898
899static struct syscore_ops acpi_sleep_syscore_ops = {
900 .suspend = acpi_save_bm_rld,
901 .resume = acpi_restore_bm_rld,
902};
903
904static void acpi_sleep_syscore_init(void)
905{
906 register_syscore_ops(ops: &acpi_sleep_syscore_ops);
907}
908#else
909static inline void acpi_sleep_syscore_init(void) {}
910#endif /* CONFIG_PM_SLEEP */
911
912#ifdef CONFIG_HIBERNATION
913static unsigned long s4_hardware_signature;
914static struct acpi_table_facs *facs;
915int acpi_check_s4_hw_signature = -1; /* Default behaviour is just to warn */
916
917static int acpi_hibernation_begin(pm_message_t stage)
918{
919 if (!nvs_nosave) {
920 int error = suspend_nvs_alloc();
921 if (error)
922 return error;
923 }
924
925 if (stage.event == PM_EVENT_HIBERNATE)
926 pm_set_suspend_via_firmware();
927
928 acpi_pm_start(ACPI_STATE_S4);
929 return 0;
930}
931
932static int acpi_hibernation_enter(void)
933{
934 acpi_status status = AE_OK;
935
936 /* This shouldn't return. If it returns, we have a problem */
937 status = acpi_enter_sleep_state(ACPI_STATE_S4);
938 /* Reprogram control registers */
939 acpi_leave_sleep_state_prep(ACPI_STATE_S4);
940
941 return ACPI_SUCCESS(status) ? 0 : -EFAULT;
942}
943
944static void acpi_hibernation_leave(void)
945{
946 pm_set_resume_via_firmware();
947 /*
948 * If ACPI is not enabled by the BIOS and the boot kernel, we need to
949 * enable it here.
950 */
951 acpi_enable();
952 /* Reprogram control registers */
953 acpi_leave_sleep_state_prep(ACPI_STATE_S4);
954 /* Check the hardware signature */
955 if (facs && s4_hardware_signature != facs->hardware_signature)
956 pr_crit("Hardware changed while hibernated, success doubtful!\n");
957 /* Restore the NVS memory area */
958 suspend_nvs_restore();
959 /* Allow EC transactions to happen. */
960 acpi_ec_unblock_transactions();
961}
962
963static void acpi_pm_thaw(void)
964{
965 acpi_ec_unblock_transactions();
966 acpi_enable_all_runtime_gpes();
967}
968
969static const struct platform_hibernation_ops acpi_hibernation_ops = {
970 .begin = acpi_hibernation_begin,
971 .end = acpi_pm_end,
972 .pre_snapshot = acpi_pm_prepare,
973 .finish = acpi_pm_finish,
974 .prepare = acpi_pm_prepare,
975 .enter = acpi_hibernation_enter,
976 .leave = acpi_hibernation_leave,
977 .pre_restore = acpi_pm_freeze,
978 .restore_cleanup = acpi_pm_thaw,
979};
980
981/**
982 * acpi_hibernation_begin_old - Set the target system sleep state to
983 * ACPI_STATE_S4 and execute the _PTS control method. This
984 * function is used if the pre-ACPI 2.0 suspend ordering has been
985 * requested.
986 */
987static int acpi_hibernation_begin_old(pm_message_t stage)
988{
989 int error;
990 /*
991 * The _TTS object should always be evaluated before the _PTS object.
992 * When the old_suspended_ordering is true, the _PTS object is
993 * evaluated in the acpi_sleep_prepare.
994 */
995 acpi_sleep_tts_switch(ACPI_STATE_S4);
996
997 error = acpi_sleep_prepare(ACPI_STATE_S4);
998 if (error)
999 return error;
1000
1001 if (!nvs_nosave) {
1002 error = suspend_nvs_alloc();
1003 if (error)
1004 return error;
1005 }
1006
1007 if (stage.event == PM_EVENT_HIBERNATE)
1008 pm_set_suspend_via_firmware();
1009
1010 acpi_target_sleep_state = ACPI_STATE_S4;
1011 acpi_scan_lock_acquire();
1012 return 0;
1013}
1014
1015/*
1016 * The following callbacks are used if the pre-ACPI 2.0 suspend ordering has
1017 * been requested.
1018 */
1019static const struct platform_hibernation_ops acpi_hibernation_ops_old = {
1020 .begin = acpi_hibernation_begin_old,
1021 .end = acpi_pm_end,
1022 .pre_snapshot = acpi_pm_pre_suspend,
1023 .prepare = acpi_pm_freeze,
1024 .finish = acpi_pm_finish,
1025 .enter = acpi_hibernation_enter,
1026 .leave = acpi_hibernation_leave,
1027 .pre_restore = acpi_pm_freeze,
1028 .restore_cleanup = acpi_pm_thaw,
1029 .recover = acpi_pm_finish,
1030};
1031
1032static void acpi_sleep_hibernate_setup(void)
1033{
1034 if (!acpi_sleep_state_supported(ACPI_STATE_S4))
1035 return;
1036
1037 hibernation_set_ops(ops: old_suspend_ordering ?
1038 &acpi_hibernation_ops_old : &acpi_hibernation_ops);
1039 sleep_states[ACPI_STATE_S4] = 1;
1040 if (!acpi_check_s4_hw_signature)
1041 return;
1042
1043 acpi_get_table(ACPI_SIG_FACS, instance: 1, out_table: (struct acpi_table_header **)&facs);
1044 if (facs) {
1045 /*
1046 * s4_hardware_signature is the local variable which is just
1047 * used to warn about mismatch after we're attempting to
1048 * resume (in violation of the ACPI specification.)
1049 */
1050 s4_hardware_signature = facs->hardware_signature;
1051
1052 if (acpi_check_s4_hw_signature > 0) {
1053 /*
1054 * If we're actually obeying the ACPI specification
1055 * then the signature is written out as part of the
1056 * swsusp header, in order to allow the boot kernel
1057 * to gracefully decline to resume.
1058 */
1059 swsusp_hardware_signature = facs->hardware_signature;
1060 }
1061 }
1062}
1063#else /* !CONFIG_HIBERNATION */
1064static inline void acpi_sleep_hibernate_setup(void) {}
1065#endif /* !CONFIG_HIBERNATION */
1066
1067static int acpi_power_off_prepare(struct sys_off_data *data)
1068{
1069 /* Prepare to power off the system */
1070 acpi_sleep_prepare(ACPI_STATE_S5);
1071 acpi_disable_all_gpes();
1072 acpi_os_wait_events_complete();
1073 return NOTIFY_DONE;
1074}
1075
1076static int acpi_power_off(struct sys_off_data *data)
1077{
1078 /* acpi_sleep_prepare(ACPI_STATE_S5) should have already been called */
1079 pr_debug("%s called\n", __func__);
1080 local_irq_disable();
1081 acpi_enter_sleep_state(ACPI_STATE_S5);
1082 return NOTIFY_DONE;
1083}
1084
1085int __init acpi_sleep_init(void)
1086{
1087 char supported[ACPI_S_STATE_COUNT * 3 + 1];
1088 char *pos = supported;
1089 int i;
1090
1091 acpi_sleep_dmi_check();
1092
1093 sleep_states[ACPI_STATE_S0] = 1;
1094
1095 acpi_sleep_syscore_init();
1096 acpi_sleep_suspend_setup();
1097 acpi_sleep_hibernate_setup();
1098
1099 if (acpi_sleep_state_supported(ACPI_STATE_S5)) {
1100 sleep_states[ACPI_STATE_S5] = 1;
1101
1102 register_sys_off_handler(mode: SYS_OFF_MODE_POWER_OFF_PREPARE,
1103 SYS_OFF_PRIO_FIRMWARE,
1104 callback: acpi_power_off_prepare, NULL);
1105
1106 register_sys_off_handler(mode: SYS_OFF_MODE_POWER_OFF,
1107 SYS_OFF_PRIO_FIRMWARE,
1108 callback: acpi_power_off, NULL);
1109
1110 /*
1111 * Windows uses S5 for reboot, so some BIOSes depend on it to
1112 * perform proper reboot.
1113 */
1114 register_sys_off_handler(mode: SYS_OFF_MODE_RESTART_PREPARE,
1115 SYS_OFF_PRIO_FIRMWARE,
1116 callback: acpi_power_off_prepare, NULL);
1117 } else {
1118 acpi_no_s5 = true;
1119 }
1120
1121 supported[0] = 0;
1122 for (i = 0; i < ACPI_S_STATE_COUNT; i++) {
1123 if (sleep_states[i])
1124 pos += sprintf(buf: pos, fmt: " S%d", i);
1125 }
1126 pr_info("(supports%s)\n", supported);
1127
1128 /*
1129 * Register the tts_notifier to reboot notifier list so that the _TTS
1130 * object can also be evaluated when the system enters S5.
1131 */
1132 register_reboot_notifier(&tts_notifier);
1133 return 0;
1134}
1135

source code of linux/drivers/acpi/sleep.c