blob: 17955e3a808e8b6c7c81e09e1aeadfbf2033695d [file] [log] [blame]
Achin Gupta7aea9082014-02-01 07:51:28 +00001/*
Louis Mayencourt1c819c32020-01-24 13:30:28 +00002 * Copyright (c) 2013-2020, ARM Limited and Contributors. All rights reserved.
Achin Gupta7aea9082014-02-01 07:51:28 +00003 *
dp-armfa3cf0b2017-05-03 09:38:09 +01004 * SPDX-License-Identifier: BSD-3-Clause
Achin Gupta7aea9082014-02-01 07:51:28 +00005 */
6
Antonio Nino Diaz864ca6f2018-10-31 15:25:35 +00007#ifndef CONTEXT_MGMT_H
8#define CONTEXT_MGMT_H
Achin Gupta7aea9082014-02-01 07:51:28 +00009
Jeenu Viswambharanbc1a9292017-02-16 14:55:15 +000010#include <assert.h>
Antonio Nino Diaz28dce9e2018-05-22 10:09:10 +010011#include <context.h>
Jeenu Viswambharanbc1a9292017-02-16 14:55:15 +000012#include <stdint.h>
Achin Gupta7aea9082014-02-01 07:51:28 +000013
Antonio Nino Diaze0f90632018-12-14 00:18:21 +000014#include <arch.h>
15
Achin Gupta7aea9082014-02-01 07:51:28 +000016/*******************************************************************************
Andrew Thoelke4e126072014-06-04 21:10:52 +010017 * Forward declarations
18 ******************************************************************************/
19struct entry_point_info;
20
21/*******************************************************************************
Achin Gupta7aea9082014-02-01 07:51:28 +000022 * Function & variable prototypes
23 ******************************************************************************/
Dan Handleya17fefa2014-05-14 12:38:32 +010024void cm_init(void);
Soby Mathewb0082d22015-04-09 13:40:55 +010025void *cm_get_context_by_index(unsigned int cpu_idx,
26 unsigned int security_state);
27void cm_set_context_by_index(unsigned int cpu_idx,
28 void *context,
29 unsigned int security_state);
Yatharth Kochar6c0566c2015-10-02 17:56:48 +010030void *cm_get_context(uint32_t security_state);
31void cm_set_context(void *context, uint32_t security_state);
Soby Mathewb0082d22015-04-09 13:40:55 +010032void cm_init_my_context(const struct entry_point_info *ep);
33void cm_init_context_by_index(unsigned int cpu_idx,
34 const struct entry_point_info *ep);
Antonio Nino Diaz28dce9e2018-05-22 10:09:10 +010035void cm_setup_context(cpu_context_t *ctx, const entry_point_info_t *ep);
Andrew Thoelke4e126072014-06-04 21:10:52 +010036void cm_prepare_el3_exit(uint32_t security_state);
Soby Mathew748be1d2016-05-05 14:10:46 +010037
Julius Werner8e0ef0f2019-07-09 14:02:43 -070038#ifdef __aarch64__
Dan Handleya17fefa2014-05-14 12:38:32 +010039void cm_el1_sysregs_context_save(uint32_t security_state);
40void cm_el1_sysregs_context_restore(uint32_t security_state);
Soby Mathewa0fedc42016-06-16 14:52:04 +010041void cm_set_elr_el3(uint32_t security_state, uintptr_t entrypoint);
Andrew Thoelke4e126072014-06-04 21:10:52 +010042void cm_set_elr_spsr_el3(uint32_t security_state,
Soby Mathewa0fedc42016-06-16 14:52:04 +010043 uintptr_t entrypoint, uint32_t spsr);
Dan Handleya17fefa2014-05-14 12:38:32 +010044void cm_write_scr_el3_bit(uint32_t security_state,
45 uint32_t bit_pos,
46 uint32_t value);
47void cm_set_next_eret_context(uint32_t security_state);
Louis Mayencourt1c819c32020-01-24 13:30:28 +000048u_register_t cm_get_scr_el3(uint32_t security_state);
Andrew Thoelke8c28fe02014-06-02 11:40:35 +010049
Andrew Thoelkec02dbd62014-06-02 10:00:25 +010050/* Inline definitions */
51
52/*******************************************************************************
Yatharth Kochar6c0566c2015-10-02 17:56:48 +010053 * This function is used to program the context that's used for exception
54 * return. This initializes the SP_EL3 to a pointer to a 'cpu_context' set for
55 * the required security state
Andrew Thoelkec02dbd62014-06-02 10:00:25 +010056 ******************************************************************************/
Sandrine Bailleux37a12df2016-04-11 13:17:50 +010057static inline void cm_set_next_context(void *context)
Andrew Thoelkec02dbd62014-06-02 10:00:25 +010058{
Antonio Nino Diaz3759e3f2017-03-22 15:48:51 +000059#if ENABLE_ASSERTIONS
Yatharth Kochar6c0566c2015-10-02 17:56:48 +010060 uint64_t sp_mode;
Andrew Thoelkec02dbd62014-06-02 10:00:25 +010061
Yatharth Kochar6c0566c2015-10-02 17:56:48 +010062 /*
63 * Check that this function is called with SP_EL0 as the stack
64 * pointer
65 */
66 __asm__ volatile("mrs %0, SPSel\n"
67 : "=r" (sp_mode));
Andrew Thoelkec02dbd62014-06-02 10:00:25 +010068
Yatharth Kochar6c0566c2015-10-02 17:56:48 +010069 assert(sp_mode == MODE_SP_EL0);
Antonio Nino Diaz3759e3f2017-03-22 15:48:51 +000070#endif /* ENABLE_ASSERTIONS */
Andrew Thoelkec02dbd62014-06-02 10:00:25 +010071
Yatharth Kochar6c0566c2015-10-02 17:56:48 +010072 __asm__ volatile("msr spsel, #1\n"
73 "mov sp, %0\n"
74 "msr spsel, #0\n"
75 : : "r" (context));
Andrew Thoelkec02dbd62014-06-02 10:00:25 +010076}
Yatharth Kochar5d361212016-06-28 17:07:09 +010077
78#else
79void *cm_get_next_context(void);
Etienne Carriere662bf932017-06-23 09:37:49 +020080void cm_set_next_context(void *context);
Julius Werner8e0ef0f2019-07-09 14:02:43 -070081#endif /* __aarch64__ */
Yatharth Kochar5d361212016-06-28 17:07:09 +010082
Antonio Nino Diaz864ca6f2018-10-31 15:25:35 +000083#endif /* CONTEXT_MGMT_H */