Home | History | Annotate | Download | only in bl1
      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 <auth.h>
     35 #include <bl_common.h>
     36 #include <debug.h>
     37 #include <platform.h>
     38 #include <platform_def.h>
     39 #include "bl1_private.h"
     40 
     41 /*******************************************************************************
     42  * Runs BL2 from the given entry point. It results in dropping the
     43  * exception level
     44  ******************************************************************************/
     45 static void __dead2 bl1_run_bl2(entry_point_info_t *bl2_ep)
     46 {
     47 	bl1_arch_next_el_setup();
     48 
     49 	/* Tell next EL what we want done */
     50 	bl2_ep->args.arg0 = RUN_IMAGE;
     51 
     52 	if (GET_SECURITY_STATE(bl2_ep->h.attr) == NON_SECURE)
     53 		change_security_state(GET_SECURITY_STATE(bl2_ep->h.attr));
     54 
     55 	write_spsr_el3(bl2_ep->spsr);
     56 	write_elr_el3(bl2_ep->pc);
     57 
     58 	eret(bl2_ep->args.arg0,
     59 		bl2_ep->args.arg1,
     60 		bl2_ep->args.arg2,
     61 		bl2_ep->args.arg3,
     62 		bl2_ep->args.arg4,
     63 		bl2_ep->args.arg5,
     64 		bl2_ep->args.arg6,
     65 		bl2_ep->args.arg7);
     66 }
     67 
     68 /*******************************************************************************
     69  * The next function has a weak definition. Platform specific code can override
     70  * it if it wishes to.
     71  ******************************************************************************/
     72 #pragma weak bl1_init_bl2_mem_layout
     73 
     74 /*******************************************************************************
     75  * Function that takes a memory layout into which BL2 has been loaded and
     76  * populates a new memory layout for BL2 that ensures that BL1's data sections
     77  * resident in secure RAM are not visible to BL2.
     78  ******************************************************************************/
     79 void bl1_init_bl2_mem_layout(const meminfo_t *bl1_mem_layout,
     80 			     meminfo_t *bl2_mem_layout)
     81 {
     82 	const size_t bl1_size = BL1_RAM_LIMIT - BL1_RAM_BASE;
     83 
     84 	assert(bl1_mem_layout != NULL);
     85 	assert(bl2_mem_layout != NULL);
     86 
     87 	/* Check that BL1's memory is lying outside of the free memory */
     88 	assert((BL1_RAM_LIMIT <= bl1_mem_layout->free_base) ||
     89 	       (BL1_RAM_BASE >= bl1_mem_layout->free_base + bl1_mem_layout->free_size));
     90 
     91 	/* Remove BL1 RW data from the scope of memory visible to BL2 */
     92 	*bl2_mem_layout = *bl1_mem_layout;
     93 	reserve_mem(&bl2_mem_layout->total_base,
     94 		    &bl2_mem_layout->total_size,
     95 		    BL1_RAM_BASE,
     96 		    bl1_size);
     97 
     98 	flush_dcache_range((unsigned long)bl2_mem_layout, sizeof(meminfo_t));
     99 }
    100 
    101 /*******************************************************************************
    102  * Function to perform late architectural and platform specific initialization.
    103  * It also locates and loads the BL2 raw binary image in the trusted DRAM. Only
    104  * called by the primary cpu after a cold boot.
    105  * TODO: Add support for alternative image load mechanism e.g using virtio/elf
    106  * loader etc.
    107   ******************************************************************************/
    108 void bl1_main(void)
    109 {
    110 	/* Announce our arrival */
    111 	NOTICE(FIRMWARE_WELCOME_STR);
    112 	NOTICE("BL1: %s\n", version_string);
    113 	NOTICE("BL1: %s\n", build_message);
    114 
    115 	INFO("BL1: RAM 0x%lx - 0x%lx\n", BL1_RAM_BASE, BL1_RAM_LIMIT);
    116 
    117 #if DEBUG
    118 	unsigned long sctlr_el3 = read_sctlr_el3();
    119 #endif
    120 	image_info_t bl2_image_info = { {0} };
    121 	entry_point_info_t bl2_ep = { {0} };
    122 	meminfo_t *bl1_tzram_layout;
    123 	meminfo_t *bl2_tzram_layout = 0x0;
    124 	int err;
    125 
    126 	/*
    127 	 * Ensure that MMU/Caches and coherency are turned on
    128 	 */
    129 	assert(sctlr_el3 | SCTLR_M_BIT);
    130 	assert(sctlr_el3 | SCTLR_C_BIT);
    131 	assert(sctlr_el3 | SCTLR_I_BIT);
    132 
    133 	/* Perform remaining generic architectural setup from EL3 */
    134 	bl1_arch_setup();
    135 
    136 	/* Perform platform setup in BL1. */
    137 	bl1_platform_setup();
    138 
    139 	SET_PARAM_HEAD(&bl2_image_info, PARAM_IMAGE_BINARY, VERSION_1, 0);
    140 	SET_PARAM_HEAD(&bl2_ep, PARAM_EP, VERSION_1, 0);
    141 
    142 	/* Find out how much free trusted ram remains after BL1 load */
    143 	bl1_tzram_layout = bl1_plat_sec_mem_layout();
    144 
    145 #if TRUSTED_BOARD_BOOT
    146 	/* Initialize authentication module */
    147 	auth_init();
    148 
    149 	/*
    150 	 * Load the BL2 certificate into the BL2 region. This region will be
    151 	 * overwritten by the image, so the authentication module is responsible
    152 	 * for storing the relevant data from the certificate (keys, hashes,
    153 	 * etc.) so it can be used later.
    154 	 */
    155 	err = load_image(bl1_tzram_layout,
    156 			 BL2_CERT_NAME,
    157 			 BL2_BASE,
    158 			 &bl2_image_info,
    159 			 NULL);
    160 	if (err) {
    161 		ERROR("Failed to load BL2 certificate.\n");
    162 		panic();
    163 	}
    164 
    165 	err = auth_verify_obj(AUTH_BL2_IMG_CERT, bl2_image_info.image_base,
    166 			bl2_image_info.image_size);
    167 	if (err) {
    168 		ERROR("Failed to validate BL2 certificate.\n");
    169 		panic();
    170 	}
    171 #endif /* TRUSTED_BOARD_BOOT */
    172 
    173 	/* Load the BL2 image */
    174 	err = load_image(bl1_tzram_layout,
    175 			 BL2_IMAGE_NAME,
    176 			 BL2_BASE,
    177 			 &bl2_image_info,
    178 			 &bl2_ep);
    179 	if (err) {
    180 		/*
    181 		 * TODO: print failure to load BL2 but also add a tzwdog timer
    182 		 * which will reset the system eventually.
    183 		 */
    184 		ERROR("Failed to load BL2 firmware.\n");
    185 		panic();
    186 	}
    187 
    188 #if TRUSTED_BOARD_BOOT
    189 	err = auth_verify_obj(AUTH_BL2_IMG, bl2_image_info.image_base,
    190 				bl2_image_info.image_size);
    191 	if (err) {
    192 		ERROR("Failed to validate BL2 image.\n");
    193 		panic();
    194 	}
    195 
    196 	/* After working with data, invalidate the data cache */
    197 	inv_dcache_range(bl2_image_info.image_base,
    198 			(size_t)bl2_image_info.image_size);
    199 #endif /* TRUSTED_BOARD_BOOT */
    200 
    201 	/*
    202 	 * Create a new layout of memory for BL2 as seen by BL1 i.e.
    203 	 * tell it the amount of total and free memory available.
    204 	 * This layout is created at the first free address visible
    205 	 * to BL2. BL2 will read the memory layout before using its
    206 	 * memory for other purposes.
    207 	 */
    208 	bl2_tzram_layout = (meminfo_t *) bl1_tzram_layout->free_base;
    209 	bl1_init_bl2_mem_layout(bl1_tzram_layout, bl2_tzram_layout);
    210 
    211 	bl1_plat_set_bl2_ep_info(&bl2_image_info, &bl2_ep);
    212 	bl2_ep.args.arg1 = (unsigned long)bl2_tzram_layout;
    213 	NOTICE("BL1: Booting BL2\n");
    214 	INFO("BL1: BL2 address = 0x%llx\n",
    215 		(unsigned long long) bl2_ep.pc);
    216 	INFO("BL1: BL2 spsr = 0x%x\n", bl2_ep.spsr);
    217 	VERBOSE("BL1: BL2 memory layout address = 0x%llx\n",
    218 		(unsigned long long) bl2_tzram_layout);
    219 
    220 	bl1_run_bl2(&bl2_ep);
    221 
    222 	return;
    223 }
    224 
    225 /*******************************************************************************
    226  * Temporary function to print the fact that BL2 has done its job and BL31 is
    227  * about to be loaded. This is needed as long as printfs cannot be used
    228  ******************************************************************************/
    229 void display_boot_progress(entry_point_info_t *bl31_ep_info)
    230 {
    231 	NOTICE("BL1: Booting BL3-1\n");
    232 	INFO("BL1: BL3-1 address = 0x%llx\n",
    233 		(unsigned long long)bl31_ep_info->pc);
    234 	INFO("BL1: BL3-1 spsr = 0x%llx\n",
    235 		(unsigned long long)bl31_ep_info->spsr);
    236 	INFO("BL1: BL3-1 params address = 0x%llx\n",
    237 		(unsigned long long)bl31_ep_info->args.arg0);
    238 	INFO("BL1: BL3-1 plat params address = 0x%llx\n",
    239 		(unsigned long long)bl31_ep_info->args.arg1);
    240 }
    241