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