blob: 0664741242a585c9ea5dd3f2ed96a6bf8a1dfbaf [file] [log] [blame]
Achin Gupta4f6ad662013-10-25 09:08:21 +01001/*
Roberto Vargas05712702018-02-12 12:36:17 +00002 * Copyright (c) 2013-2018, ARM Limited and Contributors. All rights reserved.
Achin Gupta4f6ad662013-10-25 09:08:21 +01003 *
dp-armfa3cf0b2017-05-03 09:38:09 +01004 * SPDX-License-Identifier: BSD-3-Clause
Achin Gupta4f6ad662013-10-25 09:08:21 +01005 */
6
Dan Handley2bd4ef22014-04-09 13:14:54 +01007#include <arch.h>
Achin Gupta4f6ad662013-10-25 09:08:21 +01008#include <arch_helpers.h>
Dan Handley2bd4ef22014-04-09 13:14:54 +01009#include <assert.h>
Achin Gupta4f6ad662013-10-25 09:08:21 +010010#include <bl31.h>
Isla Mitchell99305012017-07-11 14:54:08 +010011#include <bl_common.h>
Antonio Nino Diaze3962d02017-02-16 16:17:19 +000012#include <console.h>
Achin Gupta7aea9082014-02-01 07:51:28 +000013#include <context_mgmt.h>
Soby Mathewafe7e2f2014-06-12 17:23:58 +010014#include <debug.h>
Jeenu Viswambharan10a67272017-09-22 08:32:10 +010015#include <ehf.h>
Dan Handley7ce42df2014-05-15 14:11:36 +010016#include <platform.h>
dp-arm3cac7862016-09-19 11:18:44 +010017#include <pmf.h>
18#include <runtime_instr.h>
Dan Handley2bd4ef22014-04-09 13:14:54 +010019#include <runtime_svc.h>
Roberto Vargas05712702018-02-12 12:36:17 +000020#include <std_svc.h>
Vikram Kanigiri614f3952014-05-28 13:41:51 +010021#include <string.h>
Achin Gupta7aea9082014-02-01 07:51:28 +000022
dp-arm3cac7862016-09-19 11:18:44 +010023#if ENABLE_RUNTIME_INSTRUMENTATION
24PMF_REGISTER_SERVICE_SMC(rt_instr_svc, PMF_RT_INSTR_SVC_ID,
25 RT_INSTR_TOTAL_IDS, PMF_STORE_ENABLE)
26#endif
27
Jeenu Viswambharan7f366602014-02-20 17:11:00 +000028/*******************************************************************************
29 * This function pointer is used to initialise the BL32 image. It's initialized
30 * by SPD calling bl31_register_bl32_init after setting up all things necessary
31 * for SP execution. In cases where both SPD and SP are absent, or when SPD
32 * finds it impossible to execute SP, this pointer is left as NULL
33 ******************************************************************************/
Vikram Kanigirid8c9d262014-05-16 18:48:12 +010034static int32_t (*bl32_init)(void);
Jeenu Viswambharan7f366602014-02-20 17:11:00 +000035
Achin Gupta7aea9082014-02-01 07:51:28 +000036/*******************************************************************************
Achin Gupta35ca3512014-02-19 17:58:33 +000037 * Variable to indicate whether next image to execute after BL31 is BL33
38 * (non-secure & default) or BL32 (secure).
39 ******************************************************************************/
Vikram Kanigiri4e813412014-07-15 16:49:22 +010040static uint32_t next_image_type = NON_SECURE;
Achin Gupta35ca3512014-02-19 17:58:33 +000041
Soby Mathew8da89662016-09-19 17:21:15 +010042/*
43 * Implement the ARM Standard Service function to get arguments for a
44 * particular service.
45 */
46uintptr_t get_arm_std_svc_args(unsigned int svc_mask)
47{
48 /* Setup the arguments for PSCI Library */
49 DEFINE_STATIC_PSCI_LIB_ARGS_V1(psci_args, bl31_warm_entrypoint);
50
51 /* PSCI is the only ARM Standard Service implemented */
52 assert(svc_mask == PSCI_FID_MASK);
53
54 return (uintptr_t)&psci_args;
55}
56
Achin Gupta35ca3512014-02-19 17:58:33 +000057/*******************************************************************************
Achin Gupta7aea9082014-02-01 07:51:28 +000058 * Simple function to initialise all BL31 helper libraries.
59 ******************************************************************************/
Juan Castillo2d552402014-06-13 17:05:10 +010060void bl31_lib_init(void)
Achin Gupta7aea9082014-02-01 07:51:28 +000061{
62 cm_init();
63}
Achin Gupta4f6ad662013-10-25 09:08:21 +010064
Achin Gupta4f6ad662013-10-25 09:08:21 +010065/*******************************************************************************
66 * BL31 is responsible for setting up the runtime services for the primary cpu
Achin Gupta35ca3512014-02-19 17:58:33 +000067 * before passing control to the bootloader or an Operating System. This
68 * function calls runtime_svc_init() which initializes all registered runtime
69 * services. The run time services would setup enough context for the core to
70 * swtich to the next exception level. When this function returns, the core will
71 * switch to the programmed exception level via. an ERET.
Achin Gupta4f6ad662013-10-25 09:08:21 +010072 ******************************************************************************/
73void bl31_main(void)
74{
Juan Castillo7d199412015-12-14 09:35:25 +000075 NOTICE("BL31: %s\n", version_string);
76 NOTICE("BL31: %s\n", build_message);
Dan Handley91b624e2014-07-29 17:14:00 +010077
Soby Mathew1ff495b2015-12-09 11:28:43 +000078 /* Perform platform setup in BL31 */
Achin Gupta4f6ad662013-10-25 09:08:21 +010079 bl31_platform_setup();
80
Achin Gupta7aea9082014-02-01 07:51:28 +000081 /* Initialise helper libraries */
82 bl31_lib_init();
Achin Gupta4f6ad662013-10-25 09:08:21 +010083
Jeenu Viswambharan10a67272017-09-22 08:32:10 +010084#if EL3_EXCEPTION_HANDLING
85 INFO("BL31: Initialising Exception Handling Framework\n");
86 ehf_init();
87#endif
88
Soby Mathew8da89662016-09-19 17:21:15 +010089 /* Initialize the runtime services e.g. psci. */
Juan Castillo7d199412015-12-14 09:35:25 +000090 INFO("BL31: Initializing runtime services\n");
Achin Gupta7421b462014-02-01 18:53:26 +000091 runtime_svc_init();
Achin Gupta4f6ad662013-10-25 09:08:21 +010092
Achin Gupta35ca3512014-02-19 17:58:33 +000093 /*
Jeenu Viswambharan7f366602014-02-20 17:11:00 +000094 * All the cold boot actions on the primary cpu are done. We now need to
95 * decide which is the next image (BL32 or BL33) and how to execute it.
96 * If the SPD runtime service is present, it would want to pass control
97 * to BL32 first in S-EL1. In that case, SPD would have registered a
98 * function to intialize bl32 where it takes responsibility of entering
99 * S-EL1 and returning control back to bl31_main. Once this is done we
100 * can prepare entry into BL33 as normal.
Achin Gupta35ca3512014-02-19 17:58:33 +0000101 */
102
Jeenu Viswambharan7f366602014-02-20 17:11:00 +0000103 /*
Vikram Kanigirid8c9d262014-05-16 18:48:12 +0100104 * If SPD had registerd an init hook, invoke it.
Jeenu Viswambharan7f366602014-02-20 17:11:00 +0000105 */
Dan Handley91b624e2014-07-29 17:14:00 +0100106 if (bl32_init) {
Juan Castillo7d199412015-12-14 09:35:25 +0000107 INFO("BL31: Initializing BL32\n");
Vikram Kanigirid8c9d262014-05-16 18:48:12 +0100108 (*bl32_init)();
Dan Handley91b624e2014-07-29 17:14:00 +0100109 }
Achin Gupta35ca3512014-02-19 17:58:33 +0000110 /*
111 * We are ready to enter the next EL. Prepare entry into the image
112 * corresponding to the desired security state after the next ERET.
113 */
114 bl31_prepare_next_image_entry();
Soby Mathew1ff495b2015-12-09 11:28:43 +0000115
Antonio Nino Diaze3962d02017-02-16 16:17:19 +0000116 console_flush();
117
Soby Mathew1ff495b2015-12-09 11:28:43 +0000118 /*
119 * Perform any platform specific runtime setup prior to cold boot exit
120 * from BL31
121 */
122 bl31_plat_runtime_setup();
Achin Gupta35ca3512014-02-19 17:58:33 +0000123}
124
125/*******************************************************************************
126 * Accessor functions to help runtime services decide which image should be
127 * executed after BL31. This is BL33 or the non-secure bootloader image by
128 * default but the Secure payload dispatcher could override this by requesting
129 * an entry into BL32 (Secure payload) first. If it does so then it should use
130 * the same API to program an entry into BL33 once BL32 initialisation is
131 * complete.
132 ******************************************************************************/
133void bl31_set_next_image_type(uint32_t security_state)
134{
Juan Castillof558cac2014-06-05 09:45:36 +0100135 assert(sec_state_is_valid(security_state));
Achin Gupta35ca3512014-02-19 17:58:33 +0000136 next_image_type = security_state;
137}
138
139uint32_t bl31_get_next_image_type(void)
140{
141 return next_image_type;
142}
143
144/*******************************************************************************
145 * This function programs EL3 registers and performs other setup to enable entry
146 * into the next image after BL31 at the next ERET.
147 ******************************************************************************/
Juan Castillo2d552402014-06-13 17:05:10 +0100148void bl31_prepare_next_image_entry(void)
Achin Gupta35ca3512014-02-19 17:58:33 +0000149{
Vikram Kanigirida567432014-04-15 18:08:08 +0100150 entry_point_info_t *next_image_info;
Andrew Thoelke4e126072014-06-04 21:10:52 +0100151 uint32_t image_type;
Achin Gupta35ca3512014-02-19 17:58:33 +0000152
Soby Mathewd75d2ba2016-05-17 14:01:32 +0100153#if CTX_INCLUDE_AARCH32_REGS
154 /*
155 * Ensure that the build flag to save AArch32 system registers in CPU
156 * context is not set for AArch64-only platforms.
157 */
Jeenu Viswambharan2a9b8822017-02-21 14:40:44 +0000158 if (EL_IMPLEMENTED(1) == EL_IMPL_A64ONLY) {
Soby Mathewd75d2ba2016-05-17 14:01:32 +0100159 ERROR("EL1 supports AArch64-only. Please set build flag "
160 "CTX_INCLUDE_AARCH32_REGS = 0");
161 panic();
162 }
163#endif
164
Achin Gupta35ca3512014-02-19 17:58:33 +0000165 /* Determine which image to execute next */
166 image_type = bl31_get_next_image_type();
167
Jeenu Viswambharancaa84932014-02-06 10:36:15 +0000168 /* Program EL3 registers to enable entry into the next EL */
Dan Handley701fea72014-05-27 16:17:21 +0100169 next_image_info = bl31_plat_get_next_image_ep_info(image_type);
Achin Gupta35ca3512014-02-19 17:58:33 +0000170 assert(next_image_info);
Vikram Kanigiri614f3952014-05-28 13:41:51 +0100171 assert(image_type == GET_SECURITY_STATE(next_image_info->h.attr));
Achin Gupta35ca3512014-02-19 17:58:33 +0000172
Juan Castillo7d199412015-12-14 09:35:25 +0000173 INFO("BL31: Preparing for EL3 exit to %s world\n",
Dan Handley91b624e2014-07-29 17:14:00 +0100174 (image_type == SECURE) ? "secure" : "normal");
Sandrine Bailleuxb2e224c2015-09-28 17:03:06 +0100175 print_entry_point_info(next_image_info);
Soby Mathew3700a922015-07-13 11:21:11 +0100176 cm_init_my_context(next_image_info);
Andrew Thoelke4e126072014-06-04 21:10:52 +0100177 cm_prepare_el3_exit(image_type);
Achin Gupta4f6ad662013-10-25 09:08:21 +0100178}
Jeenu Viswambharan7f366602014-02-20 17:11:00 +0000179
180/*******************************************************************************
181 * This function initializes the pointer to BL32 init function. This is expected
182 * to be called by the SPD after it finishes all its initialization
183 ******************************************************************************/
Vikram Kanigirid8c9d262014-05-16 18:48:12 +0100184void bl31_register_bl32_init(int32_t (*func)(void))
Jeenu Viswambharan7f366602014-02-20 17:11:00 +0000185{
186 bl32_init = func;
187}