suspend.h

 1/* SPDX-License-Identifier: GPL-2.0-only */
 2/*
 3 * Copyright (c) 2021 Western Digital Corporation or its affiliates.
 4 * Copyright (c) 2022 Ventana Micro Systems Inc.
 5 */
 6
 7#ifndef _ASM_RISCV_SUSPEND_H
 8#define _ASM_RISCV_SUSPEND_H
 9
10#include <asm/ptrace.h>
11
12struct suspend_context {
13	/* Saved and restored by low-level functions */
14	struct pt_regs regs;
15	/* Saved and restored by high-level functions */
16	unsigned long envcfg;
17	unsigned long tvec;
18	unsigned long ie;
19#ifdef CONFIG_MMU
20	unsigned long satp;
21	unsigned long stimecmp;
22#if __riscv_xlen < 64
23	unsigned long stimecmph;
24#endif
25#endif
26};
27
28/*
29 * Used by hibernation core and cleared during resume sequence
30 */
31extern int in_suspend;
32
33/* Low-level CPU suspend entry function */
34int __cpu_suspend_enter(struct suspend_context *context);
35
36/* High-level CPU suspend which will save context and call finish() */
37int cpu_suspend(unsigned long arg,
38		int (*finish)(unsigned long arg,
39			      unsigned long entry,
40			      unsigned long context));
41
42/* Low-level CPU resume entry function */
43int __cpu_resume_enter(unsigned long hartid, unsigned long context);
44
45/* Used to save and restore the CSRs */
46void suspend_save_csrs(struct suspend_context *context);
47void suspend_restore_csrs(struct suspend_context *context);
48
49/* Low-level API to support hibernation */
50int swsusp_arch_suspend(void);
51int swsusp_arch_resume(void);
52int arch_hibernation_header_save(void *addr, unsigned int max_size);
53int arch_hibernation_header_restore(void *addr);
54int __hibernate_cpu_resume(void);
55
56/* Used to resume on the CPU we hibernated on */
57int hibernate_resume_nonboot_cpu_disable(void);
58
59asmlinkage void hibernate_restore_image(unsigned long resume_satp, unsigned long satp_temp,
60					unsigned long cpu_resume);
61asmlinkage int hibernate_core_restore_code(void);
62bool riscv_sbi_hsm_is_supported(void);
63bool riscv_sbi_suspend_state_is_valid(u32 state);
64int riscv_sbi_hart_suspend(u32 state);
65#endif