1 // SPDX-License-Identifier: GPL-2.0+
2 /*
3  * Copyright (C) 2017, Bin Meng <bmeng.cn@gmail.com>
4  */
5 
6 #include <common.h>
7 #include <acpi/acpi_s3.h>
8 #include <acpi/acpi_table.h>
9 #include <asm/acpi.h>
10 #include <asm/global_data.h>
11 #include <asm/post.h>
12 #include <linux/linkage.h>
13 
14 DECLARE_GLOBAL_DATA_PTR;
15 
16 static void asmlinkage (*acpi_do_wakeup)(void *vector) = (void *)WAKEUP_BASE;
17 
acpi_jump_to_wakeup(void * vector)18 static void acpi_jump_to_wakeup(void *vector)
19 {
20 	/* Copy wakeup trampoline in place */
21 	memcpy((void *)WAKEUP_BASE, __wakeup, __wakeup_size);
22 
23 	printf("Jumping to OS waking vector %p\n", vector);
24 	acpi_do_wakeup(vector);
25 }
26 
acpi_resume(struct acpi_fadt * fadt)27 void acpi_resume(struct acpi_fadt *fadt)
28 {
29 	void *wake_vec;
30 
31 	/* Turn on ACPI mode for S3 */
32 	enter_acpi_mode(fadt->pm1a_cnt_blk);
33 
34 	wake_vec = acpi_find_wakeup_vector(fadt);
35 
36 	/*
37 	 * Restore the memory content starting from address 0x1000 which is
38 	 * used for the real mode interrupt handler stubs.
39 	 */
40 	memcpy((void *)0x1000, (const void *)gd->arch.backup_mem,
41 	       S3_RESERVE_SIZE);
42 
43 	post_code(POST_OS_RESUME);
44 	acpi_jump_to_wakeup(wake_vec);
45 }
46 
acpi_s3_reserve(void)47 int acpi_s3_reserve(void)
48 {
49 	/* adjust stack pointer for ACPI S3 resume backup memory */
50 	gd->start_addr_sp -= S3_RESERVE_SIZE;
51 	gd->arch.backup_mem = gd->start_addr_sp;
52 
53 	gd->start_addr_sp &= ~0xf;
54 
55 	/*
56 	 * U-Boot sets up the real mode interrupt handler stubs starting from
57 	 * address 0x1000. In most cases, the first 640K (0x00000 - 0x9ffff)
58 	 * system memory is reported as system RAM in E820 table to the OS.
59 	 * (see install_e820_map() implementation for each platform). So OS
60 	 * can use these memories whatever it wants.
61 	 *
62 	 * If U-Boot is in an S3 resume path, care must be taken not to corrupt
63 	 * these memorie otherwise OS data gets lost. Testing shows that, on
64 	 * Microsoft Windows 10 on Intel Baytrail its wake up vector happens to
65 	 * be installed at the same address 0x1000. While on Linux its wake up
66 	 * vector does not overlap this memory range, but after resume kernel
67 	 * checks low memory range per config option CONFIG_X86_RESERVE_LOW
68 	 * which is 64K by default to see whether a memory corruption occurs
69 	 * during the suspend/resume (it's harmless, but warnings are shown
70 	 * in the kernel dmesg logs).
71 	 *
72 	 * We cannot simply mark the these memory as reserved in E820 table
73 	 * because such configuration makes GRUB complain: unable to allocate
74 	 * real mode page. Hence we choose to back up these memories to the
75 	 * place where we reserved on our stack for our S3 resume work.
76 	 * Before jumping to OS wake up vector, we need restore the original
77 	 * content there (see acpi_resume() above).
78 	 */
79 	if (gd->arch.prev_sleep_state == ACPI_S3)
80 		memcpy((void *)gd->arch.backup_mem, (const void *)0x1000,
81 		       S3_RESERVE_SIZE);
82 
83 	return 0;
84 }
85