blob: ca18a80aeb011ebf45f934e7f09b178d8288ad77 [file] [log] [blame]
Achin Gupta4f6ad662013-10-25 09:08:21 +01001/*
Antonio Nino Diaze3962d02017-02-16 16:17:19 +00002 * Copyright (c) 2013-2017, 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 <bl_common.h>
11#include <bl31.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>
Dan Handley7ce42df2014-05-15 14:11:36 +010015#include <platform.h>
dp-arm3cac7862016-09-19 11:18:44 +010016#include <pmf.h>
17#include <runtime_instr.h>
Dan Handley2bd4ef22014-04-09 13:14:54 +010018#include <runtime_svc.h>
Vikram Kanigiri614f3952014-05-28 13:41:51 +010019#include <string.h>
Achin Gupta7aea9082014-02-01 07:51:28 +000020
dp-arm3cac7862016-09-19 11:18:44 +010021#if ENABLE_RUNTIME_INSTRUMENTATION
22PMF_REGISTER_SERVICE_SMC(rt_instr_svc, PMF_RT_INSTR_SVC_ID,
23 RT_INSTR_TOTAL_IDS, PMF_STORE_ENABLE)
24#endif
25
Jeenu Viswambharan7f366602014-02-20 17:11:00 +000026/*******************************************************************************
27 * This function pointer is used to initialise the BL32 image. It's initialized
28 * by SPD calling bl31_register_bl32_init after setting up all things necessary
29 * for SP execution. In cases where both SPD and SP are absent, or when SPD
30 * finds it impossible to execute SP, this pointer is left as NULL
31 ******************************************************************************/
Vikram Kanigirid8c9d262014-05-16 18:48:12 +010032static int32_t (*bl32_init)(void);
Jeenu Viswambharan7f366602014-02-20 17:11:00 +000033
Achin Gupta7aea9082014-02-01 07:51:28 +000034/*******************************************************************************
Achin Gupta35ca3512014-02-19 17:58:33 +000035 * Variable to indicate whether next image to execute after BL31 is BL33
36 * (non-secure & default) or BL32 (secure).
37 ******************************************************************************/
Vikram Kanigiri4e813412014-07-15 16:49:22 +010038static uint32_t next_image_type = NON_SECURE;
Achin Gupta35ca3512014-02-19 17:58:33 +000039
Soby Mathew8da89662016-09-19 17:21:15 +010040/*
41 * Implement the ARM Standard Service function to get arguments for a
42 * particular service.
43 */
44uintptr_t get_arm_std_svc_args(unsigned int svc_mask)
45{
46 /* Setup the arguments for PSCI Library */
47 DEFINE_STATIC_PSCI_LIB_ARGS_V1(psci_args, bl31_warm_entrypoint);
48
49 /* PSCI is the only ARM Standard Service implemented */
50 assert(svc_mask == PSCI_FID_MASK);
51
52 return (uintptr_t)&psci_args;
53}
54
Achin Gupta35ca3512014-02-19 17:58:33 +000055/*******************************************************************************
Achin Gupta7aea9082014-02-01 07:51:28 +000056 * Simple function to initialise all BL31 helper libraries.
57 ******************************************************************************/
Juan Castillo2d552402014-06-13 17:05:10 +010058void bl31_lib_init(void)
Achin Gupta7aea9082014-02-01 07:51:28 +000059{
60 cm_init();
61}
Achin Gupta4f6ad662013-10-25 09:08:21 +010062
Achin Gupta4f6ad662013-10-25 09:08:21 +010063/*******************************************************************************
64 * BL31 is responsible for setting up the runtime services for the primary cpu
Achin Gupta35ca3512014-02-19 17:58:33 +000065 * before passing control to the bootloader or an Operating System. This
66 * function calls runtime_svc_init() which initializes all registered runtime
67 * services. The run time services would setup enough context for the core to
68 * swtich to the next exception level. When this function returns, the core will
69 * switch to the programmed exception level via. an ERET.
Achin Gupta4f6ad662013-10-25 09:08:21 +010070 ******************************************************************************/
71void bl31_main(void)
72{
Juan Castillo7d199412015-12-14 09:35:25 +000073 NOTICE("BL31: %s\n", version_string);
74 NOTICE("BL31: %s\n", build_message);
Dan Handley91b624e2014-07-29 17:14:00 +010075
Soby Mathew1ff495b2015-12-09 11:28:43 +000076 /* Perform platform setup in BL31 */
Achin Gupta4f6ad662013-10-25 09:08:21 +010077 bl31_platform_setup();
78
Achin Gupta7aea9082014-02-01 07:51:28 +000079 /* Initialise helper libraries */
80 bl31_lib_init();
Achin Gupta4f6ad662013-10-25 09:08:21 +010081
Soby Mathew8da89662016-09-19 17:21:15 +010082 /* Initialize the runtime services e.g. psci. */
Juan Castillo7d199412015-12-14 09:35:25 +000083 INFO("BL31: Initializing runtime services\n");
Achin Gupta7421b462014-02-01 18:53:26 +000084 runtime_svc_init();
Achin Gupta4f6ad662013-10-25 09:08:21 +010085
Achin Gupta35ca3512014-02-19 17:58:33 +000086 /*
Jeenu Viswambharan7f366602014-02-20 17:11:00 +000087 * All the cold boot actions on the primary cpu are done. We now need to
88 * decide which is the next image (BL32 or BL33) and how to execute it.
89 * If the SPD runtime service is present, it would want to pass control
90 * to BL32 first in S-EL1. In that case, SPD would have registered a
91 * function to intialize bl32 where it takes responsibility of entering
92 * S-EL1 and returning control back to bl31_main. Once this is done we
93 * can prepare entry into BL33 as normal.
Achin Gupta35ca3512014-02-19 17:58:33 +000094 */
95
Jeenu Viswambharan7f366602014-02-20 17:11:00 +000096 /*
Vikram Kanigirid8c9d262014-05-16 18:48:12 +010097 * If SPD had registerd an init hook, invoke it.
Jeenu Viswambharan7f366602014-02-20 17:11:00 +000098 */
Dan Handley91b624e2014-07-29 17:14:00 +010099 if (bl32_init) {
Juan Castillo7d199412015-12-14 09:35:25 +0000100 INFO("BL31: Initializing BL32\n");
Vikram Kanigirid8c9d262014-05-16 18:48:12 +0100101 (*bl32_init)();
Dan Handley91b624e2014-07-29 17:14:00 +0100102 }
Achin Gupta35ca3512014-02-19 17:58:33 +0000103 /*
104 * We are ready to enter the next EL. Prepare entry into the image
105 * corresponding to the desired security state after the next ERET.
106 */
107 bl31_prepare_next_image_entry();
Soby Mathew1ff495b2015-12-09 11:28:43 +0000108
Antonio Nino Diaze3962d02017-02-16 16:17:19 +0000109 console_flush();
110
Soby Mathew1ff495b2015-12-09 11:28:43 +0000111 /*
112 * Perform any platform specific runtime setup prior to cold boot exit
113 * from BL31
114 */
115 bl31_plat_runtime_setup();
Achin Gupta35ca3512014-02-19 17:58:33 +0000116}
117
118/*******************************************************************************
119 * Accessor functions to help runtime services decide which image should be
120 * executed after BL31. This is BL33 or the non-secure bootloader image by
121 * default but the Secure payload dispatcher could override this by requesting
122 * an entry into BL32 (Secure payload) first. If it does so then it should use
123 * the same API to program an entry into BL33 once BL32 initialisation is
124 * complete.
125 ******************************************************************************/
126void bl31_set_next_image_type(uint32_t security_state)
127{
Juan Castillof558cac2014-06-05 09:45:36 +0100128 assert(sec_state_is_valid(security_state));
Achin Gupta35ca3512014-02-19 17:58:33 +0000129 next_image_type = security_state;
130}
131
132uint32_t bl31_get_next_image_type(void)
133{
134 return next_image_type;
135}
136
137/*******************************************************************************
138 * This function programs EL3 registers and performs other setup to enable entry
139 * into the next image after BL31 at the next ERET.
140 ******************************************************************************/
Juan Castillo2d552402014-06-13 17:05:10 +0100141void bl31_prepare_next_image_entry(void)
Achin Gupta35ca3512014-02-19 17:58:33 +0000142{
Vikram Kanigirida567432014-04-15 18:08:08 +0100143 entry_point_info_t *next_image_info;
Andrew Thoelke4e126072014-06-04 21:10:52 +0100144 uint32_t image_type;
Achin Gupta35ca3512014-02-19 17:58:33 +0000145
Soby Mathewd75d2ba2016-05-17 14:01:32 +0100146#if CTX_INCLUDE_AARCH32_REGS
147 /*
148 * Ensure that the build flag to save AArch32 system registers in CPU
149 * context is not set for AArch64-only platforms.
150 */
151 if (((read_id_aa64pfr0_el1() >> ID_AA64PFR0_EL1_SHIFT)
152 & ID_AA64PFR0_ELX_MASK) == 0x1) {
153 ERROR("EL1 supports AArch64-only. Please set build flag "
154 "CTX_INCLUDE_AARCH32_REGS = 0");
155 panic();
156 }
157#endif
158
Achin Gupta35ca3512014-02-19 17:58:33 +0000159 /* Determine which image to execute next */
160 image_type = bl31_get_next_image_type();
161
Jeenu Viswambharancaa84932014-02-06 10:36:15 +0000162 /* Program EL3 registers to enable entry into the next EL */
Dan Handley701fea72014-05-27 16:17:21 +0100163 next_image_info = bl31_plat_get_next_image_ep_info(image_type);
Achin Gupta35ca3512014-02-19 17:58:33 +0000164 assert(next_image_info);
Vikram Kanigiri614f3952014-05-28 13:41:51 +0100165 assert(image_type == GET_SECURITY_STATE(next_image_info->h.attr));
Achin Gupta35ca3512014-02-19 17:58:33 +0000166
Juan Castillo7d199412015-12-14 09:35:25 +0000167 INFO("BL31: Preparing for EL3 exit to %s world\n",
Dan Handley91b624e2014-07-29 17:14:00 +0100168 (image_type == SECURE) ? "secure" : "normal");
Sandrine Bailleuxb2e224c2015-09-28 17:03:06 +0100169 print_entry_point_info(next_image_info);
Soby Mathew3700a922015-07-13 11:21:11 +0100170 cm_init_my_context(next_image_info);
Andrew Thoelke4e126072014-06-04 21:10:52 +0100171 cm_prepare_el3_exit(image_type);
Achin Gupta4f6ad662013-10-25 09:08:21 +0100172}
Jeenu Viswambharan7f366602014-02-20 17:11:00 +0000173
174/*******************************************************************************
175 * This function initializes the pointer to BL32 init function. This is expected
176 * to be called by the SPD after it finishes all its initialization
177 ******************************************************************************/
Vikram Kanigirid8c9d262014-05-16 18:48:12 +0100178void bl31_register_bl32_init(int32_t (*func)(void))
Jeenu Viswambharan7f366602014-02-20 17:11:00 +0000179{
180 bl32_init = func;
181}