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 #include <arch.h> 32 #include <arch_helpers.h> 33 #include <assert.h> 34 #include <bl_common.h> 35 #include <debug.h> 36 #include <platform.h> 37 #include <platform_def.h> 38 #include "bl2_private.h" 39 40 /******************************************************************************* 41 * Load the BL3-0 image if there's one. 42 * If a platform does not want to attempt to load BL3-0 image it must leave 43 * BL30_BASE undefined. 44 * Return 0 on success or if there's no BL3-0 image to load, a negative error 45 * code otherwise. 46 ******************************************************************************/ 47 static int load_bl30(void) 48 { 49 int e = 0; 50 #ifdef BL30_BASE 51 meminfo_t bl30_mem_info; 52 image_info_t bl30_image_info; 53 54 /* 55 * It is up to the platform to specify where BL3-0 should be loaded if 56 * it exists. It could create space in the secure sram or point to a 57 * completely different memory. 58 * 59 * The entry point information is not relevant in this case as the AP 60 * won't execute the BL3-0 image. 61 */ 62 INFO("BL2: Loading BL3-0\n"); 63 bl2_plat_get_bl30_meminfo(&bl30_mem_info); 64 bl30_image_info.h.version = VERSION_1; 65 e = load_image(&bl30_mem_info, 66 BL30_IMAGE_NAME, 67 BL30_BASE, 68 &bl30_image_info, 69 NULL); 70 71 if (e == 0) { 72 /* The subsequent handling of BL3-0 is platform specific */ 73 bl2_plat_handle_bl30(&bl30_image_info); 74 } 75 #endif /* BL30_BASE */ 76 77 return e; 78 } 79 80 /******************************************************************************* 81 * Load the BL3-1 image. 82 * The bl2_to_bl31_params and bl31_ep_info params will be updated with the 83 * relevant BL3-1 information. 84 * Return 0 on success, a negative error code otherwise. 85 ******************************************************************************/ 86 static int load_bl31(bl31_params_t *bl2_to_bl31_params, 87 entry_point_info_t *bl31_ep_info) 88 { 89 meminfo_t *bl2_tzram_layout; 90 int e; 91 92 INFO("BL2: Loading BL3-1\n"); 93 assert(bl2_to_bl31_params != NULL); 94 assert(bl31_ep_info != NULL); 95 96 /* Find out how much free trusted ram remains after BL2 load */ 97 bl2_tzram_layout = bl2_plat_sec_mem_layout(); 98 99 /* Set the X0 parameter to BL3-1 */ 100 bl31_ep_info->args.arg0 = (unsigned long)bl2_to_bl31_params; 101 102 /* Load the BL3-1 image */ 103 e = load_image(bl2_tzram_layout, 104 BL31_IMAGE_NAME, 105 BL31_BASE, 106 bl2_to_bl31_params->bl31_image_info, 107 bl31_ep_info); 108 109 if (e == 0) 110 bl2_plat_set_bl31_ep_info(bl2_to_bl31_params->bl31_image_info, 111 bl31_ep_info); 112 113 return e; 114 } 115 116 /******************************************************************************* 117 * Load the BL3-2 image if there's one. 118 * The bl2_to_bl31_params param will be updated with the relevant BL3-2 119 * information. 120 * If a platform does not want to attempt to load BL3-2 image it must leave 121 * BL32_BASE undefined. 122 * Return 0 on success or if there's no BL3-2 image to load, a negative error 123 * code otherwise. 124 ******************************************************************************/ 125 static int load_bl32(bl31_params_t *bl2_to_bl31_params) 126 { 127 int e = 0; 128 #ifdef BL32_BASE 129 meminfo_t bl32_mem_info; 130 131 INFO("BL2: Loading BL3-2\n"); 132 assert(bl2_to_bl31_params != NULL); 133 134 /* 135 * It is up to the platform to specify where BL3-2 should be loaded if 136 * it exists. It could create space in the secure sram or point to a 137 * completely different memory. 138 */ 139 bl2_plat_get_bl32_meminfo(&bl32_mem_info); 140 e = load_image(&bl32_mem_info, 141 BL32_IMAGE_NAME, 142 BL32_BASE, 143 bl2_to_bl31_params->bl32_image_info, 144 bl2_to_bl31_params->bl32_ep_info); 145 146 if (e == 0) { 147 bl2_plat_set_bl32_ep_info( 148 bl2_to_bl31_params->bl32_image_info, 149 bl2_to_bl31_params->bl32_ep_info); 150 } 151 #endif /* BL32_BASE */ 152 153 return e; 154 } 155 156 /******************************************************************************* 157 * Load the BL3-3 image. 158 * The bl2_to_bl31_params param will be updated with the relevant BL3-3 159 * information. 160 * Return 0 on success, a negative error code otherwise. 161 ******************************************************************************/ 162 static int load_bl33(bl31_params_t *bl2_to_bl31_params) 163 { 164 meminfo_t bl33_mem_info; 165 int e; 166 167 INFO("BL2: Loading BL3-3\n"); 168 assert(bl2_to_bl31_params != NULL); 169 170 bl2_plat_get_bl33_meminfo(&bl33_mem_info); 171 172 /* Load the BL3-3 image in non-secure memory provided by the platform */ 173 e = load_image(&bl33_mem_info, 174 BL33_IMAGE_NAME, 175 plat_get_ns_image_entrypoint(), 176 bl2_to_bl31_params->bl33_image_info, 177 bl2_to_bl31_params->bl33_ep_info); 178 179 if (e == 0) 180 bl2_plat_set_bl33_ep_info(bl2_to_bl31_params->bl33_image_info, 181 bl2_to_bl31_params->bl33_ep_info); 182 183 return e; 184 } 185 186 /******************************************************************************* 187 * The only thing to do in BL2 is to load further images and pass control to 188 * BL3-1. The memory occupied by BL2 will be reclaimed by BL3-x stages. BL2 runs 189 * entirely in S-EL1. 190 ******************************************************************************/ 191 void bl2_main(void) 192 { 193 bl31_params_t *bl2_to_bl31_params; 194 entry_point_info_t *bl31_ep_info; 195 int e; 196 197 NOTICE("BL2: %s\n", version_string); 198 NOTICE("BL2: %s\n", build_message); 199 200 /* Perform remaining generic architectural setup in S-EL1 */ 201 bl2_arch_setup(); 202 203 /* 204 * Load the subsequent bootloader images 205 */ 206 e = load_bl30(); 207 if (e) { 208 ERROR("Failed to load BL3-0 (%i)\n", e); 209 panic(); 210 } 211 212 /* Perform platform setup in BL2 after loading BL3-0 */ 213 bl2_platform_setup(); 214 215 /* 216 * Get a pointer to the memory the platform has set aside to pass 217 * information to BL3-1. 218 */ 219 bl2_to_bl31_params = bl2_plat_get_bl31_params(); 220 bl31_ep_info = bl2_plat_get_bl31_ep_info(); 221 222 e = load_bl31(bl2_to_bl31_params, bl31_ep_info); 223 if (e) { 224 ERROR("Failed to load BL3-1 (%i)\n", e); 225 panic(); 226 } 227 228 e = load_bl32(bl2_to_bl31_params); 229 if (e) 230 WARN("Failed to load BL3-2 (%i)\n", e); 231 232 e = load_bl33(bl2_to_bl31_params); 233 if (e) { 234 ERROR("Failed to load BL3-3 (%i)\n", e); 235 panic(); 236 } 237 238 /* Flush the params to be passed to memory */ 239 bl2_plat_flush_bl31_params(); 240 241 /* 242 * Run BL3-1 via an SMC to BL1. Information on how to pass control to 243 * the BL3-2 (if present) and BL3-3 software images will be passed to 244 * BL3-1 as an argument. 245 */ 246 smc(RUN_IMAGE, (unsigned long)bl31_ep_info, 0, 0, 0, 0, 0, 0); 247 } 248