1b4315306SDan Handley /* 232f0d3c6SDouglas Raillard * Copyright (c) 2015-2017, ARM Limited and Contributors. All rights reserved. 3b4315306SDan Handley * 482cb2c1aSdp-arm * SPDX-License-Identifier: BSD-3-Clause 5b4315306SDan Handley */ 6b4315306SDan Handley 7b4315306SDan Handley #include <arch_helpers.h> 8b4315306SDan Handley #include <arm_def.h> 9a8aa7fecSYatharth Kochar #include <assert.h> 10b4315306SDan Handley #include <bl_common.h> 11b4315306SDan Handley #include <console.h> 12a8aa7fecSYatharth Kochar #include <debug.h> 13a8aa7fecSYatharth Kochar #include <desc_image_load.h> 14b4315306SDan Handley #include <plat_arm.h> 15a8aa7fecSYatharth Kochar #include <platform_def.h> 16*c243e30bSdp-arm #include <platform.h> 17b4315306SDan Handley #include <string.h> 1832f0d3c6SDouglas Raillard #include <utils.h> 19b4315306SDan Handley 20b4315306SDan Handley /* Data structure which holds the extents of the trusted SRAM for BL2 */ 21b4315306SDan Handley static meminfo_t bl2_tzram_layout __aligned(CACHE_WRITEBACK_GRANULE); 22b4315306SDan Handley 23a8aa7fecSYatharth Kochar /* Weak definitions may be overridden in specific ARM standard platform */ 24a8aa7fecSYatharth Kochar #pragma weak bl2_early_platform_setup 25a8aa7fecSYatharth Kochar #pragma weak bl2_platform_setup 26a8aa7fecSYatharth Kochar #pragma weak bl2_plat_arch_setup 27a8aa7fecSYatharth Kochar #pragma weak bl2_plat_sec_mem_layout 28a8aa7fecSYatharth Kochar 29a8aa7fecSYatharth Kochar #if LOAD_IMAGE_V2 30a8aa7fecSYatharth Kochar 31a8aa7fecSYatharth Kochar #pragma weak bl2_plat_handle_post_image_load 32a8aa7fecSYatharth Kochar 33a8aa7fecSYatharth Kochar #else /* LOAD_IMAGE_V2 */ 34b4315306SDan Handley 35b4315306SDan Handley /******************************************************************************* 36b4315306SDan Handley * This structure represents the superset of information that is passed to 37d178637dSJuan Castillo * BL31, e.g. while passing control to it from BL2, bl31_params 38b4315306SDan Handley * and other platform specific params 39b4315306SDan Handley ******************************************************************************/ 40b4315306SDan Handley typedef struct bl2_to_bl31_params_mem { 41b4315306SDan Handley bl31_params_t bl31_params; 42b4315306SDan Handley image_info_t bl31_image_info; 43b4315306SDan Handley image_info_t bl32_image_info; 44b4315306SDan Handley image_info_t bl33_image_info; 45b4315306SDan Handley entry_point_info_t bl33_ep_info; 46b4315306SDan Handley entry_point_info_t bl32_ep_info; 47b4315306SDan Handley entry_point_info_t bl31_ep_info; 48b4315306SDan Handley } bl2_to_bl31_params_mem_t; 49b4315306SDan Handley 50b4315306SDan Handley 51b4315306SDan Handley static bl2_to_bl31_params_mem_t bl31_params_mem; 52b4315306SDan Handley 53b4315306SDan Handley 54b4315306SDan Handley /* Weak definitions may be overridden in specific ARM standard platform */ 55b4315306SDan Handley #pragma weak bl2_plat_get_bl31_params 56b4315306SDan Handley #pragma weak bl2_plat_get_bl31_ep_info 57b4315306SDan Handley #pragma weak bl2_plat_flush_bl31_params 58b4315306SDan Handley #pragma weak bl2_plat_set_bl31_ep_info 59f59821d5SJuan Castillo #pragma weak bl2_plat_get_scp_bl2_meminfo 60b4315306SDan Handley #pragma weak bl2_plat_get_bl32_meminfo 61b4315306SDan Handley #pragma weak bl2_plat_set_bl32_ep_info 62b4315306SDan Handley #pragma weak bl2_plat_get_bl33_meminfo 63b4315306SDan Handley #pragma weak bl2_plat_set_bl33_ep_info 64b4315306SDan Handley 654518dd9aSDavid Wang #if ARM_BL31_IN_DRAM 664518dd9aSDavid Wang meminfo_t *bl2_plat_sec_mem_layout(void) 674518dd9aSDavid Wang { 684518dd9aSDavid Wang static meminfo_t bl2_dram_layout 694518dd9aSDavid Wang __aligned(CACHE_WRITEBACK_GRANULE) = { 704518dd9aSDavid Wang .total_base = BL31_BASE, 714518dd9aSDavid Wang .total_size = (ARM_AP_TZC_DRAM1_BASE + 724518dd9aSDavid Wang ARM_AP_TZC_DRAM1_SIZE) - BL31_BASE, 734518dd9aSDavid Wang .free_base = BL31_BASE, 744518dd9aSDavid Wang .free_size = (ARM_AP_TZC_DRAM1_BASE + 754518dd9aSDavid Wang ARM_AP_TZC_DRAM1_SIZE) - BL31_BASE 764518dd9aSDavid Wang }; 77b4315306SDan Handley 784518dd9aSDavid Wang return &bl2_dram_layout; 794518dd9aSDavid Wang } 804518dd9aSDavid Wang #else 81b4315306SDan Handley meminfo_t *bl2_plat_sec_mem_layout(void) 82b4315306SDan Handley { 83b4315306SDan Handley return &bl2_tzram_layout; 84b4315306SDan Handley } 85a8aa7fecSYatharth Kochar #endif /* ARM_BL31_IN_DRAM */ 86b4315306SDan Handley 87b4315306SDan Handley /******************************************************************************* 88b4315306SDan Handley * This function assigns a pointer to the memory that the platform has kept 89b4315306SDan Handley * aside to pass platform specific and trusted firmware related information 90b4315306SDan Handley * to BL31. This memory is allocated by allocating memory to 91b4315306SDan Handley * bl2_to_bl31_params_mem_t structure which is a superset of all the 92b4315306SDan Handley * structure whose information is passed to BL31 93b4315306SDan Handley * NOTE: This function should be called only once and should be done 94b4315306SDan Handley * before generating params to BL31 95b4315306SDan Handley ******************************************************************************/ 96b4315306SDan Handley bl31_params_t *bl2_plat_get_bl31_params(void) 97b4315306SDan Handley { 98b4315306SDan Handley bl31_params_t *bl2_to_bl31_params; 99b4315306SDan Handley 100b4315306SDan Handley /* 101b4315306SDan Handley * Initialise the memory for all the arguments that needs to 102d178637dSJuan Castillo * be passed to BL31 103b4315306SDan Handley */ 10432f0d3c6SDouglas Raillard zeromem(&bl31_params_mem, sizeof(bl2_to_bl31_params_mem_t)); 105b4315306SDan Handley 106b4315306SDan Handley /* Assign memory for TF related information */ 107b4315306SDan Handley bl2_to_bl31_params = &bl31_params_mem.bl31_params; 108b4315306SDan Handley SET_PARAM_HEAD(bl2_to_bl31_params, PARAM_BL31, VERSION_1, 0); 109b4315306SDan Handley 110d178637dSJuan Castillo /* Fill BL31 related information */ 111b4315306SDan Handley bl2_to_bl31_params->bl31_image_info = &bl31_params_mem.bl31_image_info; 112b4315306SDan Handley SET_PARAM_HEAD(bl2_to_bl31_params->bl31_image_info, PARAM_IMAGE_BINARY, 113b4315306SDan Handley VERSION_1, 0); 114b4315306SDan Handley 115d178637dSJuan Castillo /* Fill BL32 related information if it exists */ 11681d139d5SAntonio Nino Diaz #ifdef BL32_BASE 117b4315306SDan Handley bl2_to_bl31_params->bl32_ep_info = &bl31_params_mem.bl32_ep_info; 118b4315306SDan Handley SET_PARAM_HEAD(bl2_to_bl31_params->bl32_ep_info, PARAM_EP, 119b4315306SDan Handley VERSION_1, 0); 120b4315306SDan Handley bl2_to_bl31_params->bl32_image_info = &bl31_params_mem.bl32_image_info; 121b4315306SDan Handley SET_PARAM_HEAD(bl2_to_bl31_params->bl32_image_info, PARAM_IMAGE_BINARY, 122b4315306SDan Handley VERSION_1, 0); 12381d139d5SAntonio Nino Diaz #endif /* BL32_BASE */ 124b4315306SDan Handley 125d178637dSJuan Castillo /* Fill BL33 related information */ 126b4315306SDan Handley bl2_to_bl31_params->bl33_ep_info = &bl31_params_mem.bl33_ep_info; 127b4315306SDan Handley SET_PARAM_HEAD(bl2_to_bl31_params->bl33_ep_info, 128b4315306SDan Handley PARAM_EP, VERSION_1, 0); 129b4315306SDan Handley 130d178637dSJuan Castillo /* BL33 expects to receive the primary CPU MPID (through x0) */ 131b4315306SDan Handley bl2_to_bl31_params->bl33_ep_info->args.arg0 = 0xffff & read_mpidr(); 132b4315306SDan Handley 133b4315306SDan Handley bl2_to_bl31_params->bl33_image_info = &bl31_params_mem.bl33_image_info; 134b4315306SDan Handley SET_PARAM_HEAD(bl2_to_bl31_params->bl33_image_info, PARAM_IMAGE_BINARY, 135b4315306SDan Handley VERSION_1, 0); 136b4315306SDan Handley 137b4315306SDan Handley return bl2_to_bl31_params; 138b4315306SDan Handley } 139b4315306SDan Handley 140b4315306SDan Handley /* Flush the TF params and the TF plat params */ 141b4315306SDan Handley void bl2_plat_flush_bl31_params(void) 142b4315306SDan Handley { 143b4315306SDan Handley flush_dcache_range((unsigned long)&bl31_params_mem, 144b4315306SDan Handley sizeof(bl2_to_bl31_params_mem_t)); 145b4315306SDan Handley } 146b4315306SDan Handley 147b4315306SDan Handley /******************************************************************************* 148b4315306SDan Handley * This function returns a pointer to the shared memory that the platform 149b4315306SDan Handley * has kept to point to entry point information of BL31 to BL2 150b4315306SDan Handley ******************************************************************************/ 151b4315306SDan Handley struct entry_point_info *bl2_plat_get_bl31_ep_info(void) 152b4315306SDan Handley { 153b4315306SDan Handley #if DEBUG 154b4315306SDan Handley bl31_params_mem.bl31_ep_info.args.arg1 = ARM_BL31_PLAT_PARAM_VAL; 155b4315306SDan Handley #endif 156b4315306SDan Handley 157b4315306SDan Handley return &bl31_params_mem.bl31_ep_info; 158b4315306SDan Handley } 159a8aa7fecSYatharth Kochar #endif /* LOAD_IMAGE_V2 */ 160b4315306SDan Handley 161b4315306SDan Handley /******************************************************************************* 162b4315306SDan Handley * BL1 has passed the extents of the trusted SRAM that should be visible to BL2 163b4315306SDan Handley * in x0. This memory layout is sitting at the base of the free trusted SRAM. 164b4315306SDan Handley * Copy it to a safe location before its reclaimed by later BL2 functionality. 165b4315306SDan Handley ******************************************************************************/ 166b4315306SDan Handley void arm_bl2_early_platform_setup(meminfo_t *mem_layout) 167b4315306SDan Handley { 168b4315306SDan Handley /* Initialize the console to provide early debug support */ 169b4315306SDan Handley console_init(PLAT_ARM_BOOT_UART_BASE, PLAT_ARM_BOOT_UART_CLK_IN_HZ, 170b4315306SDan Handley ARM_CONSOLE_BAUDRATE); 171b4315306SDan Handley 172b4315306SDan Handley /* Setup the BL2 memory layout */ 173b4315306SDan Handley bl2_tzram_layout = *mem_layout; 174b4315306SDan Handley 175b4315306SDan Handley /* Initialise the IO layer and register platform IO devices */ 176b4315306SDan Handley plat_arm_io_setup(); 177b4315306SDan Handley } 178b4315306SDan Handley 179b4315306SDan Handley void bl2_early_platform_setup(meminfo_t *mem_layout) 180b4315306SDan Handley { 181b4315306SDan Handley arm_bl2_early_platform_setup(mem_layout); 182b4315306SDan Handley } 183b4315306SDan Handley 184b4315306SDan Handley /* 185b4315306SDan Handley * Perform ARM standard platform setup. 186b4315306SDan Handley */ 187b4315306SDan Handley void arm_bl2_platform_setup(void) 188b4315306SDan Handley { 189b4315306SDan Handley /* Initialize the secure environment */ 190b4315306SDan Handley plat_arm_security_setup(); 191b4315306SDan Handley } 192b4315306SDan Handley 193b4315306SDan Handley void bl2_platform_setup(void) 194b4315306SDan Handley { 195b4315306SDan Handley arm_bl2_platform_setup(); 196b4315306SDan Handley } 197b4315306SDan Handley 198b4315306SDan Handley /******************************************************************************* 199b4315306SDan Handley * Perform the very early platform specific architectural setup here. At the 200b4315306SDan Handley * moment this is only initializes the mmu in a quick and dirty way. 201b4315306SDan Handley ******************************************************************************/ 202b4315306SDan Handley void arm_bl2_plat_arch_setup(void) 203b4315306SDan Handley { 204b5fa6563SSandrine Bailleux arm_setup_page_tables(bl2_tzram_layout.total_base, 205b4315306SDan Handley bl2_tzram_layout.total_size, 2060af559a8SSandrine Bailleux BL_CODE_BASE, 207ecdc898dSMasahiro Yamada BL_CODE_END, 2080af559a8SSandrine Bailleux BL_RO_DATA_BASE, 209ecdc898dSMasahiro Yamada BL_RO_DATA_END 210b4315306SDan Handley #if USE_COHERENT_MEM 21147497053SMasahiro Yamada , BL_COHERENT_RAM_BASE, 21247497053SMasahiro Yamada BL_COHERENT_RAM_END 213b4315306SDan Handley #endif 214b4315306SDan Handley ); 2156fe8aa2fSYatharth Kochar 2166fe8aa2fSYatharth Kochar #ifdef AARCH32 2176fe8aa2fSYatharth Kochar enable_mmu_secure(0); 2186fe8aa2fSYatharth Kochar #else 219b5fa6563SSandrine Bailleux enable_mmu_el1(0); 2206fe8aa2fSYatharth Kochar #endif 221b4315306SDan Handley } 222b4315306SDan Handley 223b4315306SDan Handley void bl2_plat_arch_setup(void) 224b4315306SDan Handley { 225b4315306SDan Handley arm_bl2_plat_arch_setup(); 226b4315306SDan Handley } 227b4315306SDan Handley 228a8aa7fecSYatharth Kochar #if LOAD_IMAGE_V2 22907570d59SYatharth Kochar int arm_bl2_handle_post_image_load(unsigned int image_id) 230a8aa7fecSYatharth Kochar { 231a8aa7fecSYatharth Kochar int err = 0; 232a8aa7fecSYatharth Kochar bl_mem_params_node_t *bl_mem_params = get_bl_mem_params_node(image_id); 233a8aa7fecSYatharth Kochar assert(bl_mem_params); 234a8aa7fecSYatharth Kochar 235a8aa7fecSYatharth Kochar switch (image_id) { 2366fe8aa2fSYatharth Kochar #ifdef AARCH64 237a8aa7fecSYatharth Kochar case BL32_IMAGE_ID: 238a8aa7fecSYatharth Kochar bl_mem_params->ep_info.spsr = arm_get_spsr_for_bl32_entry(); 239a8aa7fecSYatharth Kochar break; 2406fe8aa2fSYatharth Kochar #endif 241a8aa7fecSYatharth Kochar 242a8aa7fecSYatharth Kochar case BL33_IMAGE_ID: 243a8aa7fecSYatharth Kochar /* BL33 expects to receive the primary CPU MPID (through r0) */ 244a8aa7fecSYatharth Kochar bl_mem_params->ep_info.args.arg0 = 0xffff & read_mpidr(); 245a8aa7fecSYatharth Kochar bl_mem_params->ep_info.spsr = arm_get_spsr_for_bl33_entry(); 246a8aa7fecSYatharth Kochar break; 247a8aa7fecSYatharth Kochar 248a8aa7fecSYatharth Kochar #ifdef SCP_BL2_BASE 249a8aa7fecSYatharth Kochar case SCP_BL2_IMAGE_ID: 250a8aa7fecSYatharth Kochar /* The subsequent handling of SCP_BL2 is platform specific */ 251a8aa7fecSYatharth Kochar err = plat_arm_bl2_handle_scp_bl2(&bl_mem_params->image_info); 252a8aa7fecSYatharth Kochar if (err) { 253a8aa7fecSYatharth Kochar WARN("Failure in platform-specific handling of SCP_BL2 image.\n"); 254a8aa7fecSYatharth Kochar } 255a8aa7fecSYatharth Kochar break; 256a8aa7fecSYatharth Kochar #endif 257a8aa7fecSYatharth Kochar } 258a8aa7fecSYatharth Kochar 259a8aa7fecSYatharth Kochar return err; 260a8aa7fecSYatharth Kochar } 261a8aa7fecSYatharth Kochar 26207570d59SYatharth Kochar /******************************************************************************* 26307570d59SYatharth Kochar * This function can be used by the platforms to update/use image 26407570d59SYatharth Kochar * information for given `image_id`. 26507570d59SYatharth Kochar ******************************************************************************/ 26607570d59SYatharth Kochar int bl2_plat_handle_post_image_load(unsigned int image_id) 26707570d59SYatharth Kochar { 26807570d59SYatharth Kochar return arm_bl2_handle_post_image_load(image_id); 26907570d59SYatharth Kochar } 27007570d59SYatharth Kochar 271a8aa7fecSYatharth Kochar #else /* LOAD_IMAGE_V2 */ 272a8aa7fecSYatharth Kochar 273b4315306SDan Handley /******************************************************************************* 274f59821d5SJuan Castillo * Populate the extents of memory available for loading SCP_BL2 (if used), 275b4315306SDan Handley * i.e. anywhere in trusted RAM as long as it doesn't overwrite BL2. 276b4315306SDan Handley ******************************************************************************/ 277f59821d5SJuan Castillo void bl2_plat_get_scp_bl2_meminfo(meminfo_t *scp_bl2_meminfo) 278b4315306SDan Handley { 279f59821d5SJuan Castillo *scp_bl2_meminfo = bl2_tzram_layout; 280b4315306SDan Handley } 281b4315306SDan Handley 282b4315306SDan Handley /******************************************************************************* 283d178637dSJuan Castillo * Before calling this function BL31 is loaded in memory and its entrypoint 284b4315306SDan Handley * is set by load_image. This is a placeholder for the platform to change 285d178637dSJuan Castillo * the entrypoint of BL31 and set SPSR and security state. 286b4315306SDan Handley * On ARM standard platforms we only set the security state of the entrypoint 287b4315306SDan Handley ******************************************************************************/ 288b4315306SDan Handley void bl2_plat_set_bl31_ep_info(image_info_t *bl31_image_info, 289b4315306SDan Handley entry_point_info_t *bl31_ep_info) 290b4315306SDan Handley { 291b4315306SDan Handley SET_SECURITY_STATE(bl31_ep_info->h.attr, SECURE); 292b4315306SDan Handley bl31_ep_info->spsr = SPSR_64(MODE_EL3, MODE_SP_ELX, 293b4315306SDan Handley DISABLE_ALL_EXCEPTIONS); 294b4315306SDan Handley } 295b4315306SDan Handley 296b4315306SDan Handley 297b4315306SDan Handley /******************************************************************************* 298d178637dSJuan Castillo * Before calling this function BL32 is loaded in memory and its entrypoint 299b4315306SDan Handley * is set by load_image. This is a placeholder for the platform to change 300d178637dSJuan Castillo * the entrypoint of BL32 and set SPSR and security state. 301b4315306SDan Handley * On ARM standard platforms we only set the security state of the entrypoint 302b4315306SDan Handley ******************************************************************************/ 30381d139d5SAntonio Nino Diaz #ifdef BL32_BASE 304b4315306SDan Handley void bl2_plat_set_bl32_ep_info(image_info_t *bl32_image_info, 305b4315306SDan Handley entry_point_info_t *bl32_ep_info) 306b4315306SDan Handley { 307b4315306SDan Handley SET_SECURITY_STATE(bl32_ep_info->h.attr, SECURE); 308b4315306SDan Handley bl32_ep_info->spsr = arm_get_spsr_for_bl32_entry(); 309b4315306SDan Handley } 310b4315306SDan Handley 311b4315306SDan Handley /******************************************************************************* 312b4315306SDan Handley * Populate the extents of memory available for loading BL32 313b4315306SDan Handley ******************************************************************************/ 314b4315306SDan Handley void bl2_plat_get_bl32_meminfo(meminfo_t *bl32_meminfo) 315b4315306SDan Handley { 316b4315306SDan Handley /* 317b4315306SDan Handley * Populate the extents of memory available for loading BL32. 318b4315306SDan Handley */ 319b4315306SDan Handley bl32_meminfo->total_base = BL32_BASE; 320b4315306SDan Handley bl32_meminfo->free_base = BL32_BASE; 321b4315306SDan Handley bl32_meminfo->total_size = 322b4315306SDan Handley (TSP_SEC_MEM_BASE + TSP_SEC_MEM_SIZE) - BL32_BASE; 323b4315306SDan Handley bl32_meminfo->free_size = 324b4315306SDan Handley (TSP_SEC_MEM_BASE + TSP_SEC_MEM_SIZE) - BL32_BASE; 325b4315306SDan Handley } 32681d139d5SAntonio Nino Diaz #endif /* BL32_BASE */ 327b4315306SDan Handley 32881d139d5SAntonio Nino Diaz /******************************************************************************* 32981d139d5SAntonio Nino Diaz * Before calling this function BL33 is loaded in memory and its entrypoint 33081d139d5SAntonio Nino Diaz * is set by load_image. This is a placeholder for the platform to change 33181d139d5SAntonio Nino Diaz * the entrypoint of BL33 and set SPSR and security state. 33281d139d5SAntonio Nino Diaz * On ARM standard platforms we only set the security state of the entrypoint 33381d139d5SAntonio Nino Diaz ******************************************************************************/ 33481d139d5SAntonio Nino Diaz void bl2_plat_set_bl33_ep_info(image_info_t *image, 33581d139d5SAntonio Nino Diaz entry_point_info_t *bl33_ep_info) 33681d139d5SAntonio Nino Diaz { 33781d139d5SAntonio Nino Diaz SET_SECURITY_STATE(bl33_ep_info->h.attr, NON_SECURE); 33881d139d5SAntonio Nino Diaz bl33_ep_info->spsr = arm_get_spsr_for_bl33_entry(); 33981d139d5SAntonio Nino Diaz } 340b4315306SDan Handley 341b4315306SDan Handley /******************************************************************************* 342b4315306SDan Handley * Populate the extents of memory available for loading BL33 343b4315306SDan Handley ******************************************************************************/ 344b4315306SDan Handley void bl2_plat_get_bl33_meminfo(meminfo_t *bl33_meminfo) 345b4315306SDan Handley { 346b4315306SDan Handley bl33_meminfo->total_base = ARM_NS_DRAM1_BASE; 347b4315306SDan Handley bl33_meminfo->total_size = ARM_NS_DRAM1_SIZE; 348b4315306SDan Handley bl33_meminfo->free_base = ARM_NS_DRAM1_BASE; 349b4315306SDan Handley bl33_meminfo->free_size = ARM_NS_DRAM1_SIZE; 350b4315306SDan Handley } 351a8aa7fecSYatharth Kochar 352a8aa7fecSYatharth Kochar #endif /* LOAD_IMAGE_V2 */ 353