xref: /linux/arch/arm64/include/asm/suspend.h (revision c532de5a67a70f8533d495f8f2aaa9a0491c3ad0)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 #ifndef __ASM_SUSPEND_H
3 #define __ASM_SUSPEND_H
4 
5 #define NR_CTX_REGS 13
6 #define NR_CALLEE_SAVED_REGS 12
7 
8 /*
9  * struct cpu_suspend_ctx must be 16-byte aligned since it is allocated on
10  * the stack, which must be 16-byte aligned on v8
11  */
12 struct cpu_suspend_ctx {
13 	/*
14 	 * This struct must be kept in sync with
15 	 * cpu_do_{suspend/resume} in mm/proc.S
16 	 */
17 	u64 ctx_regs[NR_CTX_REGS];
18 	u64 sp;
19 } __aligned(16);
20 
21 /*
22  * Memory to save the cpu state is allocated on the stack by
23  * __cpu_suspend_enter()'s caller, and populated by __cpu_suspend_enter().
24  * This data must survive until cpu_resume() is called.
25  *
26  * This struct desribes the size and the layout of the saved cpu state.
27  * The layout of the callee_saved_regs is defined by the implementation
28  * of __cpu_suspend_enter(), and cpu_resume(). This struct must be passed
29  * in by the caller as __cpu_suspend_enter()'s stack-frame is gone once it
30  * returns, and the data would be subsequently corrupted by the call to the
31  * finisher.
32  */
33 struct sleep_stack_data {
34 	struct cpu_suspend_ctx	system_regs;
35 	unsigned long		callee_saved_regs[NR_CALLEE_SAVED_REGS];
36 };
37 
38 extern unsigned long *sleep_save_stash;
39 
40 extern int cpu_suspend(unsigned long arg, int (*fn)(unsigned long));
41 extern void cpu_resume(void);
42 int __cpu_suspend_enter(struct sleep_stack_data *state);
43 void __cpu_suspend_exit(void);
44 void _cpu_resume(void);
45 
46 int swsusp_arch_suspend(void);
47 int swsusp_arch_resume(void);
48 int arch_hibernation_header_save(void *addr, unsigned int max_size);
49 int arch_hibernation_header_restore(void *addr);
50 
51 /* Used to resume on the CPU we hibernated on */
52 int hibernate_resume_nonboot_cpu_disable(void);
53 
54 #endif
55