blob: 927cda2f9f0d548d646ef71eb7e6d721b299b8ae [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 <assert.h>
Vikram Kanigiri614f3952014-05-28 13:41:51 +01008#include <string.h>
Achin Gupta7aea9082014-02-01 07:51:28 +00009
Antonio Nino Diaze0f90632018-12-14 00:18:21 +000010#include <arch.h>
11#include <arch_helpers.h>
12#include <bl31/bl31.h>
13#include <bl31/ehf.h>
14#include <common/bl_common.h>
15#include <common/debug.h>
16#include <common/runtime_svc.h>
17#include <drivers/console.h>
18#include <lib/el3_runtime/context_mgmt.h>
19#include <lib/pmf/pmf.h>
20#include <lib/runtime_instr.h>
21#include <plat/common/platform.h>
22#include <services/std_svc.h>
23
dp-arm3cac7862016-09-19 11:18:44 +010024#if ENABLE_RUNTIME_INSTRUMENTATION
25PMF_REGISTER_SERVICE_SMC(rt_instr_svc, PMF_RT_INSTR_SVC_ID,
26 RT_INSTR_TOTAL_IDS, PMF_STORE_ENABLE)
27#endif
28
Jeenu Viswambharan7f366602014-02-20 17:11:00 +000029/*******************************************************************************
30 * This function pointer is used to initialise the BL32 image. It's initialized
31 * by SPD calling bl31_register_bl32_init after setting up all things necessary
32 * for SP execution. In cases where both SPD and SP are absent, or when SPD
33 * finds it impossible to execute SP, this pointer is left as NULL
34 ******************************************************************************/
Vikram Kanigirid8c9d262014-05-16 18:48:12 +010035static int32_t (*bl32_init)(void);
Jeenu Viswambharan7f366602014-02-20 17:11:00 +000036
Achin Gupta7aea9082014-02-01 07:51:28 +000037/*******************************************************************************
Achin Gupta35ca3512014-02-19 17:58:33 +000038 * Variable to indicate whether next image to execute after BL31 is BL33
39 * (non-secure & default) or BL32 (secure).
40 ******************************************************************************/
Vikram Kanigiri4e813412014-07-15 16:49:22 +010041static uint32_t next_image_type = NON_SECURE;
Achin Gupta35ca3512014-02-19 17:58:33 +000042
Soby Mathew8da89662016-09-19 17:21:15 +010043/*
44 * Implement the ARM Standard Service function to get arguments for a
45 * particular service.
46 */
47uintptr_t get_arm_std_svc_args(unsigned int svc_mask)
48{
49 /* Setup the arguments for PSCI Library */
50 DEFINE_STATIC_PSCI_LIB_ARGS_V1(psci_args, bl31_warm_entrypoint);
51
52 /* PSCI is the only ARM Standard Service implemented */
53 assert(svc_mask == PSCI_FID_MASK);
54
55 return (uintptr_t)&psci_args;
56}
57
Achin Gupta35ca3512014-02-19 17:58:33 +000058/*******************************************************************************
Achin Gupta7aea9082014-02-01 07:51:28 +000059 * Simple function to initialise all BL31 helper libraries.
60 ******************************************************************************/
Daniel Boulby5753e492018-09-20 14:12:46 +010061void __init bl31_lib_init(void)
Achin Gupta7aea9082014-02-01 07:51:28 +000062{
63 cm_init();
64}
Achin Gupta4f6ad662013-10-25 09:08:21 +010065
Achin Gupta4f6ad662013-10-25 09:08:21 +010066/*******************************************************************************
67 * BL31 is responsible for setting up the runtime services for the primary cpu
Achin Gupta35ca3512014-02-19 17:58:33 +000068 * before passing control to the bootloader or an Operating System. This
69 * function calls runtime_svc_init() which initializes all registered runtime
70 * services. The run time services would setup enough context for the core to
71 * swtich to the next exception level. When this function returns, the core will
72 * switch to the programmed exception level via. an ERET.
Achin Gupta4f6ad662013-10-25 09:08:21 +010073 ******************************************************************************/
74void bl31_main(void)
75{
Juan Castillo7d199412015-12-14 09:35:25 +000076 NOTICE("BL31: %s\n", version_string);
77 NOTICE("BL31: %s\n", build_message);
Dan Handley91b624e2014-07-29 17:14:00 +010078
Soby Mathew1ff495b2015-12-09 11:28:43 +000079 /* Perform platform setup in BL31 */
Achin Gupta4f6ad662013-10-25 09:08:21 +010080 bl31_platform_setup();
81
Achin Gupta7aea9082014-02-01 07:51:28 +000082 /* Initialise helper libraries */
83 bl31_lib_init();
Achin Gupta4f6ad662013-10-25 09:08:21 +010084
Jeenu Viswambharan10a67272017-09-22 08:32:10 +010085#if EL3_EXCEPTION_HANDLING
86 INFO("BL31: Initialising Exception Handling Framework\n");
87 ehf_init();
88#endif
89
Soby Mathew8da89662016-09-19 17:21:15 +010090 /* Initialize the runtime services e.g. psci. */
Juan Castillo7d199412015-12-14 09:35:25 +000091 INFO("BL31: Initializing runtime services\n");
Achin Gupta7421b462014-02-01 18:53:26 +000092 runtime_svc_init();
Achin Gupta4f6ad662013-10-25 09:08:21 +010093
Achin Gupta35ca3512014-02-19 17:58:33 +000094 /*
Jeenu Viswambharan7f366602014-02-20 17:11:00 +000095 * All the cold boot actions on the primary cpu are done. We now need to
96 * decide which is the next image (BL32 or BL33) and how to execute it.
97 * If the SPD runtime service is present, it would want to pass control
98 * to BL32 first in S-EL1. In that case, SPD would have registered a
99 * function to intialize bl32 where it takes responsibility of entering
100 * S-EL1 and returning control back to bl31_main. Once this is done we
101 * can prepare entry into BL33 as normal.
Achin Gupta35ca3512014-02-19 17:58:33 +0000102 */
103
Jeenu Viswambharan7f366602014-02-20 17:11:00 +0000104 /*
Vikram Kanigirid8c9d262014-05-16 18:48:12 +0100105 * If SPD had registerd an init hook, invoke it.
Jeenu Viswambharan7f366602014-02-20 17:11:00 +0000106 */
Antonio Nino Diaze0b757d2018-08-24 16:30:29 +0100107 if (bl32_init != NULL) {
Juan Castillo7d199412015-12-14 09:35:25 +0000108 INFO("BL31: Initializing BL32\n");
Antonio Nino Diaze0b757d2018-08-24 16:30:29 +0100109
110 int32_t rc = (*bl32_init)();
111
Antonio Nino Diazf417a462018-09-18 13:10:47 +0100112 if (rc == 0)
113 WARN("BL31: BL32 initialization failed\n");
Dan Handley91b624e2014-07-29 17:14:00 +0100114 }
Achin Gupta35ca3512014-02-19 17:58:33 +0000115 /*
116 * We are ready to enter the next EL. Prepare entry into the image
117 * corresponding to the desired security state after the next ERET.
118 */
119 bl31_prepare_next_image_entry();
Soby Mathew1ff495b2015-12-09 11:28:43 +0000120
Antonio Nino Diaze3962d02017-02-16 16:17:19 +0000121 console_flush();
122
Soby Mathew1ff495b2015-12-09 11:28:43 +0000123 /*
124 * Perform any platform specific runtime setup prior to cold boot exit
125 * from BL31
126 */
127 bl31_plat_runtime_setup();
Achin Gupta35ca3512014-02-19 17:58:33 +0000128}
129
130/*******************************************************************************
131 * Accessor functions to help runtime services decide which image should be
132 * executed after BL31. This is BL33 or the non-secure bootloader image by
133 * default but the Secure payload dispatcher could override this by requesting
134 * an entry into BL32 (Secure payload) first. If it does so then it should use
135 * the same API to program an entry into BL33 once BL32 initialisation is
136 * complete.
137 ******************************************************************************/
138void bl31_set_next_image_type(uint32_t security_state)
139{
Juan Castillof558cac2014-06-05 09:45:36 +0100140 assert(sec_state_is_valid(security_state));
Achin Gupta35ca3512014-02-19 17:58:33 +0000141 next_image_type = security_state;
142}
143
144uint32_t bl31_get_next_image_type(void)
145{
146 return next_image_type;
147}
148
149/*******************************************************************************
150 * This function programs EL3 registers and performs other setup to enable entry
151 * into the next image after BL31 at the next ERET.
152 ******************************************************************************/
Daniel Boulby5753e492018-09-20 14:12:46 +0100153void __init bl31_prepare_next_image_entry(void)
Achin Gupta35ca3512014-02-19 17:58:33 +0000154{
Vikram Kanigirida567432014-04-15 18:08:08 +0100155 entry_point_info_t *next_image_info;
Andrew Thoelke4e126072014-06-04 21:10:52 +0100156 uint32_t image_type;
Achin Gupta35ca3512014-02-19 17:58:33 +0000157
Soby Mathewd75d2ba2016-05-17 14:01:32 +0100158#if CTX_INCLUDE_AARCH32_REGS
159 /*
160 * Ensure that the build flag to save AArch32 system registers in CPU
161 * context is not set for AArch64-only platforms.
162 */
Antonio Nino Diaz864ca6f2018-10-31 15:25:35 +0000163 if (el_implemented(1) == EL_IMPL_A64ONLY) {
Soby Mathewd75d2ba2016-05-17 14:01:32 +0100164 ERROR("EL1 supports AArch64-only. Please set build flag "
Antonio Nino Diaz864ca6f2018-10-31 15:25:35 +0000165 "CTX_INCLUDE_AARCH32_REGS = 0\n");
Soby Mathewd75d2ba2016-05-17 14:01:32 +0100166 panic();
167 }
168#endif
169
Achin Gupta35ca3512014-02-19 17:58:33 +0000170 /* Determine which image to execute next */
171 image_type = bl31_get_next_image_type();
172
Jeenu Viswambharancaa84932014-02-06 10:36:15 +0000173 /* Program EL3 registers to enable entry into the next EL */
Dan Handley701fea72014-05-27 16:17:21 +0100174 next_image_info = bl31_plat_get_next_image_ep_info(image_type);
Antonio Nino Diaze0b757d2018-08-24 16:30:29 +0100175 assert(next_image_info != NULL);
Vikram Kanigiri614f3952014-05-28 13:41:51 +0100176 assert(image_type == GET_SECURITY_STATE(next_image_info->h.attr));
Achin Gupta35ca3512014-02-19 17:58:33 +0000177
Juan Castillo7d199412015-12-14 09:35:25 +0000178 INFO("BL31: Preparing for EL3 exit to %s world\n",
Dan Handley91b624e2014-07-29 17:14:00 +0100179 (image_type == SECURE) ? "secure" : "normal");
Sandrine Bailleuxb2e224c2015-09-28 17:03:06 +0100180 print_entry_point_info(next_image_info);
Soby Mathew3700a922015-07-13 11:21:11 +0100181 cm_init_my_context(next_image_info);
Andrew Thoelke4e126072014-06-04 21:10:52 +0100182 cm_prepare_el3_exit(image_type);
Achin Gupta4f6ad662013-10-25 09:08:21 +0100183}
Jeenu Viswambharan7f366602014-02-20 17:11:00 +0000184
185/*******************************************************************************
186 * This function initializes the pointer to BL32 init function. This is expected
187 * to be called by the SPD after it finishes all its initialization
188 ******************************************************************************/
Vikram Kanigirid8c9d262014-05-16 18:48:12 +0100189void bl31_register_bl32_init(int32_t (*func)(void))
Jeenu Viswambharan7f366602014-02-20 17:11:00 +0000190{
191 bl32_init = func;
192}