1 /* 2 * Copyright (c) 2013-2017, ARM Limited and Contributors. All rights reserved. 3 * 4 * Redistribution and use in source and binary forms, with or without 5 * modification, are permitted provided that the following conditions are met: 6 * 7 * Redistributions of source code must retain the above copyright notice, this 8 * list of conditions and the following disclaimer. 9 * 10 * Redistributions in binary form must reproduce the above copyright notice, 11 * this list of conditions and the following disclaimer in the documentation 12 * and/or other materials provided with the distribution. 13 * 14 * Neither the name of ARM nor the names of its contributors may be used 15 * to endorse or promote products derived from this software without specific 16 * prior written permission. 17 * 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 19 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 21 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE 22 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 23 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 24 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 25 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 26 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 27 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 28 * POSSIBILITY OF SUCH DAMAGE. 29 */ 30 31 #ifndef __CM_H__ 32 #define __CM_H__ 33 34 #ifndef AARCH32 35 #include <arch.h> 36 #endif 37 38 /******************************************************************************* 39 * Forward declarations 40 ******************************************************************************/ 41 struct entry_point_info; 42 43 /******************************************************************************* 44 * Function & variable prototypes 45 ******************************************************************************/ 46 void cm_init(void); 47 void *cm_get_context_by_index(unsigned int cpu_idx, 48 unsigned int security_state); 49 void cm_set_context_by_index(unsigned int cpu_idx, 50 void *context, 51 unsigned int security_state); 52 void *cm_get_context(uint32_t security_state); 53 void cm_set_context(void *context, uint32_t security_state); 54 void cm_init_my_context(const struct entry_point_info *ep); 55 void cm_init_context_by_index(unsigned int cpu_idx, 56 const struct entry_point_info *ep); 57 void cm_prepare_el3_exit(uint32_t security_state); 58 59 #ifndef AARCH32 60 void cm_el1_sysregs_context_save(uint32_t security_state); 61 void cm_el1_sysregs_context_restore(uint32_t security_state); 62 void cm_set_elr_el3(uint32_t security_state, uintptr_t entrypoint); 63 void cm_set_elr_spsr_el3(uint32_t security_state, 64 uintptr_t entrypoint, uint32_t spsr); 65 void cm_write_scr_el3_bit(uint32_t security_state, 66 uint32_t bit_pos, 67 uint32_t value); 68 void cm_set_next_eret_context(uint32_t security_state); 69 uint32_t cm_get_scr_el3(uint32_t security_state); 70 71 72 void cm_init_context(uint64_t mpidr, 73 const struct entry_point_info *ep) __deprecated; 74 75 void *cm_get_context_by_mpidr(uint64_t mpidr, 76 uint32_t security_state) __deprecated; 77 void cm_set_context_by_mpidr(uint64_t mpidr, 78 void *context, 79 uint32_t security_state) __deprecated; 80 81 /* Inline definitions */ 82 83 /******************************************************************************* 84 * This function is used to program the context that's used for exception 85 * return. This initializes the SP_EL3 to a pointer to a 'cpu_context' set for 86 * the required security state 87 ******************************************************************************/ 88 static inline void cm_set_next_context(void *context) 89 { 90 #if ENABLE_ASSERTIONS 91 uint64_t sp_mode; 92 93 /* 94 * Check that this function is called with SP_EL0 as the stack 95 * pointer 96 */ 97 __asm__ volatile("mrs %0, SPSel\n" 98 : "=r" (sp_mode)); 99 100 assert(sp_mode == MODE_SP_EL0); 101 #endif /* ENABLE_ASSERTIONS */ 102 103 __asm__ volatile("msr spsel, #1\n" 104 "mov sp, %0\n" 105 "msr spsel, #0\n" 106 : : "r" (context)); 107 } 108 109 #else 110 void *cm_get_next_context(void); 111 #endif /* AARCH32 */ 112 113 #endif /* __CM_H__ */ 114