14f6ad66aSAchin Gupta /* 2ec7c29abSBoyan Karatotev * Copyright (c) 2013-2025, Arm Limited and Contributors. All rights reserved. 34f6ad66aSAchin Gupta * 482cb2c1aSdp-arm * SPDX-License-Identifier: BSD-3-Clause 54f6ad66aSAchin Gupta */ 64f6ad66aSAchin Gupta 7ed108b56SAlexei Fedorov #include <assert.h> 8ed108b56SAlexei Fedorov 94f6ad66aSAchin Gupta #include <arch_helpers.h> 10ed108b56SAlexei Fedorov #include <arch_features.h> 1109d40e0eSAntonio Nino Diaz #include <bl1/bl1.h> 1209d40e0eSAntonio Nino Diaz #include <bl2/bl2.h> 1309d40e0eSAntonio Nino Diaz #include <common/bl_common.h> 14758ccb80SChris Kay #include <common/build_message.h> 1509d40e0eSAntonio Nino Diaz #include <common/debug.h> 1609d40e0eSAntonio Nino Diaz #include <drivers/auth/auth_mod.h> 170aa0b3afSManish V Badarkhe #include <drivers/auth/crypto_mod.h> 1809d40e0eSAntonio Nino Diaz #include <drivers/console.h> 19396b339dSManish V Badarkhe #include <drivers/fwu/fwu.h> 20ed8f06ddSthagon01-arm #include <lib/bootmarker_capture.h> 21ed108b56SAlexei Fedorov #include <lib/extensions/pauth.h> 22ed8f06ddSthagon01-arm #include <lib/pmf/pmf.h> 2309d40e0eSAntonio Nino Diaz #include <plat/common/platform.h> 2409d40e0eSAntonio Nino Diaz 255b827a8fSDan Handley #include "bl2_private.h" 264f6ad66aSAchin Gupta 27402b3cf8SJulius Werner #ifdef __aarch64__ 28b1d27b48SRoberto Vargas #define NEXT_IMAGE "BL31" 29402b3cf8SJulius Werner #else 30402b3cf8SJulius Werner #define NEXT_IMAGE "BL32" 31b1d27b48SRoberto Vargas #endif 3293d81d64SSandrine Bailleux 33ed8f06ddSthagon01-arm #if ENABLE_RUNTIME_INSTRUMENTATION 34ed8f06ddSthagon01-arm PMF_REGISTER_SERVICE(bl_svc, PMF_RT_INSTR_SVC_ID, 35ed8f06ddSthagon01-arm BL_TOTAL_IDS, PMF_DUMP_ENABLE); 36ed8f06ddSthagon01-arm #endif 37ed8f06ddSthagon01-arm 3842d4d3baSArvind Ram Prakash #if RESET_TO_BL2 3993d81d64SSandrine Bailleux /******************************************************************************* 4042d4d3baSArvind Ram Prakash * Setup function for BL2 when RESET_TO_BL2=1 41dcbfa11bSAntonio Nino Diaz ******************************************************************************/ 42dcbfa11bSAntonio Nino Diaz void bl2_el3_setup(u_register_t arg0, u_register_t arg1, u_register_t arg2, 43dcbfa11bSAntonio Nino Diaz u_register_t arg3) 44dcbfa11bSAntonio Nino Diaz { 45ae770fedSYann Gautier /* Enable early console if EARLY_CONSOLE flag is enabled */ 46ae770fedSYann Gautier plat_setup_early_console(); 47ae770fedSYann Gautier 48dcbfa11bSAntonio Nino Diaz /* Perform early platform-specific setup */ 49dcbfa11bSAntonio Nino Diaz bl2_el3_early_platform_setup(arg0, arg1, arg2, arg3); 50dcbfa11bSAntonio Nino Diaz 51dcbfa11bSAntonio Nino Diaz /* Perform late platform-specific setup */ 52dcbfa11bSAntonio Nino Diaz bl2_el3_plat_arch_setup(); 53dcbfa11bSAntonio Nino Diaz } 5442d4d3baSArvind Ram Prakash #else /* RESET_TO_BL2 */ 5542d4d3baSArvind Ram Prakash 566c09af9fSZelalem Aweke /******************************************************************************* 5742d4d3baSArvind Ram Prakash * Setup function for BL2 when RESET_TO_BL2=0 586c09af9fSZelalem Aweke ******************************************************************************/ 596c09af9fSZelalem Aweke void bl2_setup(u_register_t arg0, u_register_t arg1, u_register_t arg2, 606c09af9fSZelalem Aweke u_register_t arg3) 616c09af9fSZelalem Aweke { 62ae770fedSYann Gautier /* Enable early console if EARLY_CONSOLE flag is enabled */ 63ae770fedSYann Gautier plat_setup_early_console(); 64ae770fedSYann Gautier 656c09af9fSZelalem Aweke /* Perform early platform-specific setup */ 666c09af9fSZelalem Aweke bl2_early_platform_setup2(arg0, arg1, arg2, arg3); 676c09af9fSZelalem Aweke 686c09af9fSZelalem Aweke /* Perform late platform-specific setup */ 696c09af9fSZelalem Aweke bl2_plat_arch_setup(); 706c09af9fSZelalem Aweke } 7142d4d3baSArvind Ram Prakash #endif /* RESET_TO_BL2 */ 72dcbfa11bSAntonio Nino Diaz 739d93fc2fSAntonio Nino Diaz /******************************************************************************* 7493d81d64SSandrine Bailleux * The only thing to do in BL2 is to load further images and pass control to 7542019bf4SYatharth Kochar * next BL. The memory occupied by BL2 will be reclaimed by BL3x stages. BL2 7642019bf4SYatharth Kochar * runs entirely in S-EL1. 7793d81d64SSandrine Bailleux ******************************************************************************/ 7893d81d64SSandrine Bailleux void bl2_main(void) 7993d81d64SSandrine Bailleux { 8042019bf4SYatharth Kochar entry_point_info_t *next_bl_ep_info; 8193d81d64SSandrine Bailleux 82ed8f06ddSthagon01-arm #if ENABLE_RUNTIME_INSTRUMENTATION 83ed8f06ddSthagon01-arm PMF_CAPTURE_TIMESTAMP(bl_svc, BL2_ENTRY, PMF_CACHE_MAINT); 84ed8f06ddSthagon01-arm #endif 85ed8f06ddSthagon01-arm 86758ccb80SChris Kay NOTICE("BL2: %s\n", build_version_string); 876ad2e461SDan Handley NOTICE("BL2: %s\n", build_message); 886ad2e461SDan Handley 8993d81d64SSandrine Bailleux /* Perform remaining generic architectural setup in S-EL1 */ 9093d81d64SSandrine Bailleux bl2_arch_setup(); 9193d81d64SSandrine Bailleux 92396b339dSManish V Badarkhe #if PSA_FWU_SUPPORT 93396b339dSManish V Badarkhe fwu_init(); 94396b339dSManish V Badarkhe #endif /* PSA_FWU_SUPPORT */ 95396b339dSManish V Badarkhe 960aa0b3afSManish V Badarkhe crypto_mod_init(); 970aa0b3afSManish V Badarkhe 98dec840afSJuan Castillo /* Initialize authentication module */ 991779ba6bSJuan Castillo auth_mod_init(); 100dec840afSJuan Castillo 10147bf3ac3SManish V Badarkhe /* Initialize the Measured Boot backend */ 10247bf3ac3SManish V Badarkhe bl2_plat_mboot_init(); 10347bf3ac3SManish V Badarkhe 1043f498b0dSAlexei Fedorov /* Initialize boot source */ 10501f62b6dSRoberto Vargas bl2_plat_preload_setup(); 10601f62b6dSRoberto Vargas 10742019bf4SYatharth Kochar /* Load the subsequent bootloader images. */ 10842019bf4SYatharth Kochar next_bl_ep_info = bl2_load_images(); 109ef538c6fSJuan Castillo 11047bf3ac3SManish V Badarkhe /* Teardown the Measured Boot backend */ 11147bf3ac3SManish V Badarkhe bl2_plat_mboot_finish(); 1123f498b0dSAlexei Fedorov 113*055c97afSLauren Wehrmeister crypto_mod_finish(); 114*055c97afSLauren Wehrmeister 11542d4d3baSArvind Ram Prakash #if !BL2_RUNS_AT_EL3 116402b3cf8SJulius Werner #ifndef __aarch64__ 117d48c12e9SYatharth Kochar /* 118d48c12e9SYatharth Kochar * For AArch32 state BL1 and BL2 share the MMU setup. 119d48c12e9SYatharth Kochar * Given that BL2 does not map BL1 regions, MMU needs 120d48c12e9SYatharth Kochar * to be disabled in order to go back to BL1. 121d48c12e9SYatharth Kochar */ 122d48c12e9SYatharth Kochar disable_mmu_icache_secure(); 123402b3cf8SJulius Werner #endif /* !__aarch64__ */ 124d48c12e9SYatharth Kochar 125ed108b56SAlexei Fedorov /* 126ed108b56SAlexei Fedorov * Disable pointer authentication before running next boot image 127ed108b56SAlexei Fedorov */ 1288d9f5f25SBoyan Karatotev if (is_feat_pauth_supported()) { 129ed108b56SAlexei Fedorov pauth_disable_el1(); 1308d9f5f25SBoyan Karatotev } 131ed108b56SAlexei Fedorov 132ed8f06ddSthagon01-arm #if ENABLE_RUNTIME_INSTRUMENTATION 133ed8f06ddSthagon01-arm PMF_CAPTURE_TIMESTAMP(bl_svc, BL2_EXIT, PMF_CACHE_MAINT); 134ed8f06ddSthagon01-arm #endif 135ed8f06ddSthagon01-arm 136ed8f06ddSthagon01-arm console_flush(); 137ed8f06ddSthagon01-arm 13893d81d64SSandrine Bailleux /* 13942019bf4SYatharth Kochar * Run next BL image via an SMC to BL1. Information on how to pass 14042019bf4SYatharth Kochar * control to the BL32 (if present) and BL33 software images will 14142019bf4SYatharth Kochar * be passed to next BL image as an argument. 14293d81d64SSandrine Bailleux */ 14342019bf4SYatharth Kochar smc(BL1_SMC_RUN_IMAGE, (unsigned long)next_bl_ep_info, 0, 0, 0, 0, 0, 0); 14442d4d3baSArvind Ram Prakash #else /* if BL2_RUNS_AT_EL3 */ 14542d4d3baSArvind Ram Prakash 146b1d27b48SRoberto Vargas NOTICE("BL2: Booting " NEXT_IMAGE "\n"); 147b1d27b48SRoberto Vargas print_entry_point_info(next_bl_ep_info); 148ed8f06ddSthagon01-arm #if ENABLE_RUNTIME_INSTRUMENTATION 149ed8f06ddSthagon01-arm PMF_CAPTURE_TIMESTAMP(bl_svc, BL2_EXIT, PMF_CACHE_MAINT); 150ed8f06ddSthagon01-arm #endif 151b1d27b48SRoberto Vargas console_flush(); 152b1d27b48SRoberto Vargas 153ed108b56SAlexei Fedorov /* 154ed108b56SAlexei Fedorov * Disable pointer authentication before running next boot image 155ed108b56SAlexei Fedorov */ 1568d9f5f25SBoyan Karatotev if (is_feat_pauth_supported()) { 157ed108b56SAlexei Fedorov pauth_disable_el3(); 1588d9f5f25SBoyan Karatotev } 159ed108b56SAlexei Fedorov 160b1d27b48SRoberto Vargas bl2_run_next_image(next_bl_ep_info); 16142d4d3baSArvind Ram Prakash #endif /* BL2_RUNS_AT_EL3 */ 1624f6ad66aSAchin Gupta } 163