1 /* 2 * Copyright (c) 2015-2016, 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 <arm_def.h> 34 #include <assert.h> 35 #include <bl_common.h> 36 #include <console.h> 37 #include <mmio.h> 38 #include <plat_arm.h> 39 #include <platform.h> 40 41 #define BL31_END (unsigned long)(&__BL31_END__) 42 43 #if USE_COHERENT_MEM 44 /* 45 * The next 2 constants identify the extents of the coherent memory region. 46 * These addresses are used by the MMU setup code and therefore they must be 47 * page-aligned. It is the responsibility of the linker script to ensure that 48 * __COHERENT_RAM_START__ and __COHERENT_RAM_END__ linker symbols 49 * refer to page-aligned addresses. 50 */ 51 #define BL31_COHERENT_RAM_BASE (unsigned long)(&__COHERENT_RAM_START__) 52 #define BL31_COHERENT_RAM_LIMIT (unsigned long)(&__COHERENT_RAM_END__) 53 #endif 54 55 /* 56 * Placeholder variables for copying the arguments that have been passed to 57 * BL31 from BL2. 58 */ 59 static entry_point_info_t bl32_image_ep_info; 60 static entry_point_info_t bl33_image_ep_info; 61 62 63 /* Weak definitions may be overridden in specific ARM standard platform */ 64 #pragma weak bl31_early_platform_setup 65 #pragma weak bl31_platform_setup 66 #pragma weak bl31_plat_arch_setup 67 #pragma weak bl31_plat_get_next_image_ep_info 68 69 70 /******************************************************************************* 71 * Return a pointer to the 'entry_point_info' structure of the next image for the 72 * security state specified. BL33 corresponds to the non-secure image type 73 * while BL32 corresponds to the secure image type. A NULL pointer is returned 74 * if the image does not exist. 75 ******************************************************************************/ 76 entry_point_info_t *bl31_plat_get_next_image_ep_info(uint32_t type) 77 { 78 entry_point_info_t *next_image_info; 79 80 assert(sec_state_is_valid(type)); 81 next_image_info = (type == NON_SECURE) 82 ? &bl33_image_ep_info : &bl32_image_ep_info; 83 /* 84 * None of the images on the ARM development platforms can have 0x0 85 * as the entrypoint 86 */ 87 if (next_image_info->pc) 88 return next_image_info; 89 else 90 return NULL; 91 } 92 93 /******************************************************************************* 94 * Perform any BL31 early platform setup common to ARM standard platforms. 95 * Here is an opportunity to copy parameters passed by the calling EL (S-EL1 96 * in BL2 & S-EL3 in BL1) before they are lost (potentially). This needs to be 97 * done before the MMU is initialized so that the memory layout can be used 98 * while creating page tables. BL2 has flushed this information to memory, so 99 * we are guaranteed to pick up good data. 100 ******************************************************************************/ 101 void arm_bl31_early_platform_setup(bl31_params_t *from_bl2, 102 void *plat_params_from_bl2) 103 { 104 /* Initialize the console to provide early debug support */ 105 console_init(PLAT_ARM_BOOT_UART_BASE, PLAT_ARM_BOOT_UART_CLK_IN_HZ, 106 ARM_CONSOLE_BAUDRATE); 107 108 #if RESET_TO_BL31 109 /* There are no parameters from BL2 if BL31 is a reset vector */ 110 assert(from_bl2 == NULL); 111 assert(plat_params_from_bl2 == NULL); 112 113 #ifdef BL32_BASE 114 /* Populate entry point information for BL32 */ 115 SET_PARAM_HEAD(&bl32_image_ep_info, 116 PARAM_EP, 117 VERSION_1, 118 0); 119 SET_SECURITY_STATE(bl32_image_ep_info.h.attr, SECURE); 120 bl32_image_ep_info.pc = BL32_BASE; 121 bl32_image_ep_info.spsr = arm_get_spsr_for_bl32_entry(); 122 #endif /* BL32_BASE */ 123 124 /* Populate entry point information for BL33 */ 125 SET_PARAM_HEAD(&bl33_image_ep_info, 126 PARAM_EP, 127 VERSION_1, 128 0); 129 /* 130 * Tell BL31 where the non-trusted software image 131 * is located and the entry state information 132 */ 133 #ifdef PRELOADED_BL33_BASE 134 bl33_image_ep_info.pc = PRELOADED_BL33_BASE; 135 #else 136 bl33_image_ep_info.pc = plat_get_ns_image_entrypoint(); 137 #endif /* PRELOADED_BL33_BASE */ 138 bl33_image_ep_info.spsr = arm_get_spsr_for_bl33_entry(); 139 SET_SECURITY_STATE(bl33_image_ep_info.h.attr, NON_SECURE); 140 141 #else 142 /* 143 * Check params passed from BL2 should not be NULL, 144 */ 145 assert(from_bl2 != NULL); 146 assert(from_bl2->h.type == PARAM_BL31); 147 assert(from_bl2->h.version >= VERSION_1); 148 /* 149 * In debug builds, we pass a special value in 'plat_params_from_bl2' 150 * to verify platform parameters from BL2 to BL31. 151 * In release builds, it's not used. 152 */ 153 assert(((unsigned long long)plat_params_from_bl2) == 154 ARM_BL31_PLAT_PARAM_VAL); 155 156 /* 157 * Copy BL32 (if populated by BL2) and BL33 entry point information. 158 * They are stored in Secure RAM, in BL2's address space. 159 */ 160 if (from_bl2->bl32_ep_info) 161 bl32_image_ep_info = *from_bl2->bl32_ep_info; 162 bl33_image_ep_info = *from_bl2->bl33_ep_info; 163 #endif 164 } 165 166 void bl31_early_platform_setup(bl31_params_t *from_bl2, 167 void *plat_params_from_bl2) 168 { 169 arm_bl31_early_platform_setup(from_bl2, plat_params_from_bl2); 170 171 /* 172 * Initialize Interconnect for this cluster during cold boot. 173 * No need for locks as no other CPU is active. 174 */ 175 plat_arm_interconnect_init(); 176 177 /* 178 * Enable Interconnect coherency for the primary CPU's cluster. 179 * Earlier bootloader stages might already do this (e.g. Trusted 180 * Firmware's BL1 does it) but we can't assume so. There is no harm in 181 * executing this code twice anyway. 182 * Platform specific PSCI code will enable coherency for other 183 * clusters. 184 */ 185 plat_arm_interconnect_enter_coherency(); 186 } 187 188 /******************************************************************************* 189 * Perform any BL31 platform setup common to ARM standard platforms 190 ******************************************************************************/ 191 void arm_bl31_platform_setup(void) 192 { 193 /* Initialize the GIC driver, cpu and distributor interfaces */ 194 plat_arm_gic_driver_init(); 195 plat_arm_gic_init(); 196 197 #if RESET_TO_BL31 198 /* 199 * Do initial security configuration to allow DRAM/device access 200 * (if earlier BL has not already done so). 201 */ 202 plat_arm_security_setup(); 203 204 #endif /* RESET_TO_BL31 */ 205 206 /* Enable and initialize the System level generic timer */ 207 mmio_write_32(ARM_SYS_CNTCTL_BASE + CNTCR_OFF, 208 CNTCR_FCREQ(0) | CNTCR_EN); 209 210 /* Allow access to the System counter timer module */ 211 arm_configure_sys_timer(); 212 213 /* Initialize power controller before setting up topology */ 214 plat_arm_pwrc_setup(); 215 } 216 217 /******************************************************************************* 218 * Perform any BL31 platform runtime setup prior to BL31 exit common to ARM 219 * standard platforms 220 ******************************************************************************/ 221 void arm_bl31_plat_runtime_setup(void) 222 { 223 /* Initialize the runtime console */ 224 console_init(PLAT_ARM_BL31_RUN_UART_BASE, PLAT_ARM_BL31_RUN_UART_CLK_IN_HZ, 225 ARM_CONSOLE_BAUDRATE); 226 } 227 228 void bl31_platform_setup(void) 229 { 230 arm_bl31_platform_setup(); 231 } 232 233 void bl31_plat_runtime_setup(void) 234 { 235 arm_bl31_plat_runtime_setup(); 236 } 237 238 /******************************************************************************* 239 * Perform the very early platform specific architectural setup shared between 240 * ARM standard platforms. This only does basic initialization. Later 241 * architectural setup (bl31_arch_setup()) does not do anything platform 242 * specific. 243 ******************************************************************************/ 244 void arm_bl31_plat_arch_setup(void) 245 { 246 arm_setup_page_tables(BL31_BASE, 247 BL31_END - BL31_BASE, 248 BL_CODE_BASE, 249 BL_CODE_LIMIT, 250 BL_RO_DATA_BASE, 251 BL_RO_DATA_LIMIT 252 #if USE_COHERENT_MEM 253 , BL31_COHERENT_RAM_BASE, 254 BL31_COHERENT_RAM_LIMIT 255 #endif 256 ); 257 enable_mmu_el3(0); 258 } 259 260 void bl31_plat_arch_setup(void) 261 { 262 arm_bl31_plat_arch_setup(); 263 } 264