blob: 62bea010bd53dd990bc65ff5a153a30980a833d3 [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 ******************************************************************************/
Daniel Boulby5753e492018-09-20 14:12:46 +010060void __init 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 */
Antonio Nino Diaze0b757d2018-08-24 16:30:29 +0100106 if (bl32_init != NULL) {
Juan Castillo7d199412015-12-14 09:35:25 +0000107 INFO("BL31: Initializing BL32\n");
Antonio Nino Diaze0b757d2018-08-24 16:30:29 +0100108
109 int32_t rc = (*bl32_init)();
110
Antonio Nino Diazf417a462018-09-18 13:10:47 +0100111 if (rc == 0)
112 WARN("BL31: BL32 initialization failed\n");
Dan Handley91b624e2014-07-29 17:14:00 +0100113 }
Achin Gupta35ca3512014-02-19 17:58:33 +0000114 /*
115 * We are ready to enter the next EL. Prepare entry into the image
116 * corresponding to the desired security state after the next ERET.
117 */
118 bl31_prepare_next_image_entry();
Soby Mathew1ff495b2015-12-09 11:28:43 +0000119
Antonio Nino Diaze3962d02017-02-16 16:17:19 +0000120 console_flush();
121
Soby Mathew1ff495b2015-12-09 11:28:43 +0000122 /*
123 * Perform any platform specific runtime setup prior to cold boot exit
124 * from BL31
125 */
126 bl31_plat_runtime_setup();
Achin Gupta35ca3512014-02-19 17:58:33 +0000127}
128
129/*******************************************************************************
130 * Accessor functions to help runtime services decide which image should be
131 * executed after BL31. This is BL33 or the non-secure bootloader image by
132 * default but the Secure payload dispatcher could override this by requesting
133 * an entry into BL32 (Secure payload) first. If it does so then it should use
134 * the same API to program an entry into BL33 once BL32 initialisation is
135 * complete.
136 ******************************************************************************/
137void bl31_set_next_image_type(uint32_t security_state)
138{
Juan Castillof558cac2014-06-05 09:45:36 +0100139 assert(sec_state_is_valid(security_state));
Achin Gupta35ca3512014-02-19 17:58:33 +0000140 next_image_type = security_state;
141}
142
143uint32_t bl31_get_next_image_type(void)
144{
145 return next_image_type;
146}
147
148/*******************************************************************************
149 * This function programs EL3 registers and performs other setup to enable entry
150 * into the next image after BL31 at the next ERET.
151 ******************************************************************************/
Daniel Boulby5753e492018-09-20 14:12:46 +0100152void __init bl31_prepare_next_image_entry(void)
Achin Gupta35ca3512014-02-19 17:58:33 +0000153{
Vikram Kanigirida567432014-04-15 18:08:08 +0100154 entry_point_info_t *next_image_info;
Andrew Thoelke4e126072014-06-04 21:10:52 +0100155 uint32_t image_type;
Achin Gupta35ca3512014-02-19 17:58:33 +0000156
Soby Mathewd75d2ba2016-05-17 14:01:32 +0100157#if CTX_INCLUDE_AARCH32_REGS
158 /*
159 * Ensure that the build flag to save AArch32 system registers in CPU
160 * context is not set for AArch64-only platforms.
161 */
Jeenu Viswambharan2a9b8822017-02-21 14:40:44 +0000162 if (EL_IMPLEMENTED(1) == EL_IMPL_A64ONLY) {
Soby Mathewd75d2ba2016-05-17 14:01:32 +0100163 ERROR("EL1 supports AArch64-only. Please set build flag "
164 "CTX_INCLUDE_AARCH32_REGS = 0");
165 panic();
166 }
167#endif
168
Achin Gupta35ca3512014-02-19 17:58:33 +0000169 /* Determine which image to execute next */
170 image_type = bl31_get_next_image_type();
171
Jeenu Viswambharancaa84932014-02-06 10:36:15 +0000172 /* Program EL3 registers to enable entry into the next EL */
Dan Handley701fea72014-05-27 16:17:21 +0100173 next_image_info = bl31_plat_get_next_image_ep_info(image_type);
Antonio Nino Diaze0b757d2018-08-24 16:30:29 +0100174 assert(next_image_info != NULL);
Vikram Kanigiri614f3952014-05-28 13:41:51 +0100175 assert(image_type == GET_SECURITY_STATE(next_image_info->h.attr));
Achin Gupta35ca3512014-02-19 17:58:33 +0000176
Juan Castillo7d199412015-12-14 09:35:25 +0000177 INFO("BL31: Preparing for EL3 exit to %s world\n",
Dan Handley91b624e2014-07-29 17:14:00 +0100178 (image_type == SECURE) ? "secure" : "normal");
Sandrine Bailleuxb2e224c2015-09-28 17:03:06 +0100179 print_entry_point_info(next_image_info);
Soby Mathew3700a922015-07-13 11:21:11 +0100180 cm_init_my_context(next_image_info);
Andrew Thoelke4e126072014-06-04 21:10:52 +0100181 cm_prepare_el3_exit(image_type);
Achin Gupta4f6ad662013-10-25 09:08:21 +0100182}
Jeenu Viswambharan7f366602014-02-20 17:11:00 +0000183
184/*******************************************************************************
185 * This function initializes the pointer to BL32 init function. This is expected
186 * to be called by the SPD after it finishes all its initialization
187 ******************************************************************************/
Vikram Kanigirid8c9d262014-05-16 18:48:12 +0100188void bl31_register_bl32_init(int32_t (*func)(void))
Jeenu Viswambharan7f366602014-02-20 17:11:00 +0000189{
190 bl32_init = func;
191}