1 /* 2 * Copyright (c) 2013-2014, 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 __SPD_PRIVATE_H__ 32 #define __SPD_PRIVATE_H__ 33 34 #include <context.h> 35 #include <arch.h> 36 #include <psci.h> 37 #include <tsp.h> 38 #include <cassert.h> 39 40 /******************************************************************************* 41 * Secure Payload PM state information e.g. SP is suspended, uninitialised etc 42 ******************************************************************************/ 43 #define TSP_STATE_OFF 0 44 #define TSP_STATE_ON 1 45 #define TSP_STATE_SUSPEND 2 46 47 /******************************************************************************* 48 * Secure Payload execution state information i.e. aarch32 or aarch64 49 ******************************************************************************/ 50 #define TSP_AARCH32 MODE_RW_32 51 #define TSP_AARCH64 MODE_RW_64 52 53 /******************************************************************************* 54 * The SPD should know the type of Secure Payload. 55 ******************************************************************************/ 56 #define TSP_TYPE_UP PSCI_TOS_NOT_UP_MIG_CAP 57 #define TSP_TYPE_UPM PSCI_TOS_UP_MIG_CAP 58 #define TSP_TYPE_MP PSCI_TOS_NOT_PRESENT_MP 59 60 /******************************************************************************* 61 * Secure Payload migrate type information as known to the SPD. We assume that 62 * the SPD is dealing with an MP Secure Payload. 63 ******************************************************************************/ 64 #define TSP_MIGRATE_INFO TSP_TYPE_MP 65 66 /******************************************************************************* 67 * Number of cpus that the present on this platform. TODO: Rely on a topology 68 * tree to determine this in the future to avoid assumptions about mpidr 69 * allocation 70 ******************************************************************************/ 71 #define TSPD_CORE_COUNT PLATFORM_CORE_COUNT 72 73 /******************************************************************************* 74 * Constants that allow assembler code to preserve callee-saved registers of the 75 * C runtime context while performing a security state switch. 76 ******************************************************************************/ 77 #define TSPD_C_RT_CTX_X19 0x0 78 #define TSPD_C_RT_CTX_X20 0x8 79 #define TSPD_C_RT_CTX_X21 0x10 80 #define TSPD_C_RT_CTX_X22 0x18 81 #define TSPD_C_RT_CTX_X23 0x20 82 #define TSPD_C_RT_CTX_X24 0x28 83 #define TSPD_C_RT_CTX_X25 0x30 84 #define TSPD_C_RT_CTX_X26 0x38 85 #define TSPD_C_RT_CTX_X27 0x40 86 #define TSPD_C_RT_CTX_X28 0x48 87 #define TSPD_C_RT_CTX_X29 0x50 88 #define TSPD_C_RT_CTX_X30 0x58 89 #define TSPD_C_RT_CTX_SIZE 0x60 90 #define TSPD_C_RT_CTX_ENTRIES (TSPD_C_RT_CTX_SIZE >> DWORD_SHIFT) 91 92 #ifndef __ASSEMBLY__ 93 94 /* AArch64 callee saved general purpose register context structure. */ 95 DEFINE_REG_STRUCT(c_rt_regs, TSPD_C_RT_CTX_ENTRIES); 96 97 /* 98 * Compile time assertion to ensure that both the compiler and linker 99 * have the same double word aligned view of the size of the C runtime 100 * register context. 101 */ 102 CASSERT(TSPD_C_RT_CTX_SIZE == sizeof(c_rt_regs_t), \ 103 assert_spd_c_rt_regs_size_mismatch); 104 105 /******************************************************************************* 106 * Structure which helps the SPD to maintain the per-cpu state of the SP. 107 * 'state' - collection of flags to track SP state e.g. on/off 108 * 'mpidr' - mpidr to associate a context with a cpu 109 * 'c_rt_ctx' - stack address to restore C runtime context from after returning 110 * from a synchronous entry into the SP. 111 * 'cpu_ctx' - space to maintain SP architectural state 112 ******************************************************************************/ 113 typedef struct tsp_context { 114 uint32_t state; 115 uint64_t mpidr; 116 uint64_t c_rt_ctx; 117 cpu_context_t cpu_ctx; 118 } tsp_context_t; 119 120 /* TSPD power management handlers */ 121 extern const spd_pm_ops_t tspd_pm; 122 123 /******************************************************************************* 124 * Function & Data prototypes 125 ******************************************************************************/ 126 extern uint64_t tspd_enter_sp(uint64_t *c_rt_ctx); 127 extern void __dead2 tspd_exit_sp(uint64_t c_rt_ctx, uint64_t ret); 128 extern uint64_t tspd_synchronous_sp_entry(tsp_context_t *tsp_ctx); 129 extern void __dead2 tspd_synchronous_sp_exit(tsp_context_t *tsp_ctx, uint64_t ret); 130 extern int32_t tspd_init_secure_context(uint64_t entrypoint, 131 uint32_t rw, 132 uint64_t mpidr, 133 tsp_context_t *tsp_ctx); 134 extern tsp_context_t tspd_sp_context[TSPD_CORE_COUNT]; 135 extern entry_info_t *tsp_entry_info; 136 #endif /*__ASSEMBLY__*/ 137 138 #endif /* __SPD_PRIVATE_H__ */ 139