1f91c3cb1SSiva Durga Prasad Paladugu /*
201907f3fSHarrison Mutai * Copyright (c) 2018-2025, Arm Limited and Contributors. All rights reserved.
3e497421dSTanmay Shah * Copyright (c) 2018-2022, Xilinx, Inc. All rights reserved.
409ac1ca2SMaheedhar Bollapalli * Copyright (c) 2022-2024, Advanced Micro Devices, Inc. All rights reserved.
5f91c3cb1SSiva Durga Prasad Paladugu *
6f91c3cb1SSiva Durga Prasad Paladugu * SPDX-License-Identifier: BSD-3-Clause
7f91c3cb1SSiva Durga Prasad Paladugu */
8f91c3cb1SSiva Durga Prasad Paladugu
9f91c3cb1SSiva Durga Prasad Paladugu #include <assert.h>
10f91c3cb1SSiva Durga Prasad Paladugu #include <errno.h>
1101a326abSPrasad Kummari
1209d40e0eSAntonio Nino Diaz #include <bl31/bl31.h>
1309d40e0eSAntonio Nino Diaz #include <common/bl_common.h>
1409d40e0eSAntonio Nino Diaz #include <common/debug.h>
1509ac1ca2SMaheedhar Bollapalli #include <drivers/generic_delay_timer.h>
1631ce893eSVenkatesh Yadav Abbarapu #include <lib/mmio.h>
170e9f54e5SMichal Simek #include <lib/xlat_tables/xlat_tables_v2.h>
1809d40e0eSAntonio Nino Diaz #include <plat/common/platform.h>
1901a326abSPrasad Kummari #include <plat_arm.h>
207c36fbccSPrasad Kummari #include <plat_console.h>
2101a326abSPrasad Kummari
2272b9f52dSPrasad Kummari #include <custom_svc.h>
2372b9f52dSPrasad Kummari #include <plat_clkfunc.h>
2456d1857eSAmit Nagal #include <plat_fdt.h>
2531ce893eSVenkatesh Yadav Abbarapu #include <plat_private.h>
2631ce893eSVenkatesh Yadav Abbarapu #include <plat_startup.h>
27205c7ad4SVenkatesh Yadav Abbarapu #include "pm_api_sys.h"
2801a326abSPrasad Kummari #include "pm_client.h"
2901a326abSPrasad Kummari #include <pm_ipi.h>
3001a326abSPrasad Kummari #include <versal_def.h>
3109d40e0eSAntonio Nino Diaz
32f91c3cb1SSiva Durga Prasad Paladugu static entry_point_info_t bl32_image_ep_info;
33f91c3cb1SSiva Durga Prasad Paladugu static entry_point_info_t bl33_image_ep_info;
34f91c3cb1SSiva Durga Prasad Paladugu
35f91c3cb1SSiva Durga Prasad Paladugu /*
36f91c3cb1SSiva Durga Prasad Paladugu * Return a pointer to the 'entry_point_info' structure of the next image for
37f91c3cb1SSiva Durga Prasad Paladugu * the security state specified. BL33 corresponds to the non-secure image type
38f91c3cb1SSiva Durga Prasad Paladugu * while BL32 corresponds to the secure image type. A NULL pointer is returned
39f91c3cb1SSiva Durga Prasad Paladugu * if the image does not exist.
40f91c3cb1SSiva Durga Prasad Paladugu */
bl31_plat_get_next_image_ep_info(uint32_t type)41f91c3cb1SSiva Durga Prasad Paladugu entry_point_info_t *bl31_plat_get_next_image_ep_info(uint32_t type)
42f91c3cb1SSiva Durga Prasad Paladugu {
43f91c3cb1SSiva Durga Prasad Paladugu assert(sec_state_is_valid(type));
44f91c3cb1SSiva Durga Prasad Paladugu
45e43258faSVenkatesh Yadav Abbarapu if (type == NON_SECURE) {
46f91c3cb1SSiva Durga Prasad Paladugu return &bl33_image_ep_info;
47e43258faSVenkatesh Yadav Abbarapu }
48f91c3cb1SSiva Durga Prasad Paladugu
49f91c3cb1SSiva Durga Prasad Paladugu return &bl32_image_ep_info;
50f91c3cb1SSiva Durga Prasad Paladugu }
51f91c3cb1SSiva Durga Prasad Paladugu
52f91c3cb1SSiva Durga Prasad Paladugu /*
5331ce893eSVenkatesh Yadav Abbarapu * Set the build time defaults,if we can't find any config data.
5431ce893eSVenkatesh Yadav Abbarapu */
bl31_set_default_config(void)5531ce893eSVenkatesh Yadav Abbarapu static inline void bl31_set_default_config(void)
5631ce893eSVenkatesh Yadav Abbarapu {
5793d46256SAbhyuday Godhasara bl32_image_ep_info.pc = (uintptr_t)BL32_BASE;
5801907f3fSHarrison Mutai bl32_image_ep_info.spsr = (uint32_t)arm_get_spsr(BL32_IMAGE_ID);
5993d46256SAbhyuday Godhasara bl33_image_ep_info.pc = (uintptr_t)plat_get_ns_image_entrypoint();
6093d46256SAbhyuday Godhasara bl33_image_ep_info.spsr = (uint32_t)SPSR_64(MODE_EL2, MODE_SP_ELX,
6131ce893eSVenkatesh Yadav Abbarapu DISABLE_ALL_EXCEPTIONS);
6231ce893eSVenkatesh Yadav Abbarapu }
6331ce893eSVenkatesh Yadav Abbarapu
6431ce893eSVenkatesh Yadav Abbarapu /*
65f91c3cb1SSiva Durga Prasad Paladugu * Perform any BL31 specific platform actions. Here is an opportunity to copy
66f91c3cb1SSiva Durga Prasad Paladugu * parameters passed by the calling EL (S-EL1 in BL2 & S-EL3 in BL1) before they
67f91c3cb1SSiva Durga Prasad Paladugu * are lost (potentially). This needs to be done before the MMU is initialized
68f91c3cb1SSiva Durga Prasad Paladugu * so that the memory layout can be used while creating page tables.
69f91c3cb1SSiva Durga Prasad Paladugu */
bl31_early_platform_setup2(u_register_t arg0,u_register_t arg1,u_register_t arg2,u_register_t arg3)70f91c3cb1SSiva Durga Prasad Paladugu void bl31_early_platform_setup2(u_register_t arg0, u_register_t arg1,
71f91c3cb1SSiva Durga Prasad Paladugu u_register_t arg2, u_register_t arg3)
72f91c3cb1SSiva Durga Prasad Paladugu {
73ab9aab38SMaheedhar Bollapalli (void)arg0;
74ab9aab38SMaheedhar Bollapalli (void)arg1;
75ab9aab38SMaheedhar Bollapalli (void)arg2;
76ab9aab38SMaheedhar Bollapalli (void)arg3;
77c8be2240SPrasad Kummari uint64_t tfa_handoff_addr;
78c1b0a52bSSaivardhan Thatikonda uint32_t payload[PAYLOAD_ARG_CNT], max_size = (uint32_t)HANDOFF_PARAMS_MAX_SIZE;
79205c7ad4SVenkatesh Yadav Abbarapu enum pm_ret_status ret_status;
800f9f5575SMaheedhar Bollapalli const uint64_t addr[HANDOFF_PARAMS_MAX_SIZE];
81f91c3cb1SSiva Durga Prasad Paladugu
82f91c3cb1SSiva Durga Prasad Paladugu /*
83f91c3cb1SSiva Durga Prasad Paladugu * Do initial security configuration to allow DRAM/device access. On
84f91c3cb1SSiva Durga Prasad Paladugu * Base VERSAL only DRAM security is programmable (via TrustZone), but
85f91c3cb1SSiva Durga Prasad Paladugu * other platforms might have more programmable security devices
86f91c3cb1SSiva Durga Prasad Paladugu * present.
87f91c3cb1SSiva Durga Prasad Paladugu */
8809ac1ca2SMaheedhar Bollapalli versal_config_setup();
8909ac1ca2SMaheedhar Bollapalli
9009ac1ca2SMaheedhar Bollapalli /* Initialize the platform config for future decision making */
9109ac1ca2SMaheedhar Bollapalli board_detection();
9209ac1ca2SMaheedhar Bollapalli
9309ac1ca2SMaheedhar Bollapalli switch (platform_id) {
9409ac1ca2SMaheedhar Bollapalli case VERSAL_SPP:
9509ac1ca2SMaheedhar Bollapalli cpu_clock = 2720000;
9609ac1ca2SMaheedhar Bollapalli break;
9709ac1ca2SMaheedhar Bollapalli case VERSAL_EMU:
9809ac1ca2SMaheedhar Bollapalli cpu_clock = 212000;
9909ac1ca2SMaheedhar Bollapalli break;
10009ac1ca2SMaheedhar Bollapalli case VERSAL_QEMU:
10109ac1ca2SMaheedhar Bollapalli case VERSAL_SILICON:
10209ac1ca2SMaheedhar Bollapalli cpu_clock = 100000000;
10309ac1ca2SMaheedhar Bollapalli break;
10409ac1ca2SMaheedhar Bollapalli default:
10509ac1ca2SMaheedhar Bollapalli panic();
10609ac1ca2SMaheedhar Bollapalli }
10709ac1ca2SMaheedhar Bollapalli set_cnt_freq();
10809ac1ca2SMaheedhar Bollapalli
10909ac1ca2SMaheedhar Bollapalli generic_delay_timer_init();
11009ac1ca2SMaheedhar Bollapalli
11109ac1ca2SMaheedhar Bollapalli setup_console();
11209ac1ca2SMaheedhar Bollapalli
11309ac1ca2SMaheedhar Bollapalli NOTICE("TF-A running on %s %d\n", board_name_decode(), platform_version);
114f91c3cb1SSiva Durga Prasad Paladugu
115f91c3cb1SSiva Durga Prasad Paladugu /* Populate common information for BL32 and BL33 */
116f91c3cb1SSiva Durga Prasad Paladugu SET_PARAM_HEAD(&bl32_image_ep_info, PARAM_EP, VERSION_1, 0);
117f91c3cb1SSiva Durga Prasad Paladugu SET_SECURITY_STATE(bl32_image_ep_info.h.attr, SECURE);
118f91c3cb1SSiva Durga Prasad Paladugu SET_PARAM_HEAD(&bl33_image_ep_info, PARAM_EP, VERSION_1, 0);
119f91c3cb1SSiva Durga Prasad Paladugu SET_SECURITY_STATE(bl33_image_ep_info.h.attr, NON_SECURE);
120f91c3cb1SSiva Durga Prasad Paladugu
121b802b278SMaheedhar Bollapalli PM_PACK_PAYLOAD4(payload, LOADER_MODULE_ID, 1U, PM_LOAD_GET_HANDOFF_PARAMS,
122205c7ad4SVenkatesh Yadav Abbarapu (uintptr_t)addr >> 32U, (uintptr_t)addr, max_size);
123205c7ad4SVenkatesh Yadav Abbarapu ret_status = pm_ipi_send_sync(primary_proc, payload, NULL, 0);
124205c7ad4SVenkatesh Yadav Abbarapu if (ret_status == PM_RET_SUCCESS) {
125205c7ad4SVenkatesh Yadav Abbarapu INFO("BL31: GET_HANDOFF_PARAMS call success=%d\n", ret_status);
126c8be2240SPrasad Kummari tfa_handoff_addr = (uintptr_t)&addr;
127205c7ad4SVenkatesh Yadav Abbarapu } else {
128c8be2240SPrasad Kummari ERROR("BL31: GET_HANDOFF_PARAMS Failed, read tfa_handoff_addr from reg\n");
129c8be2240SPrasad Kummari tfa_handoff_addr = mmio_read_32(PMC_GLOBAL_GLOB_GEN_STORAGE4);
130205c7ad4SVenkatesh Yadav Abbarapu }
131205c7ad4SVenkatesh Yadav Abbarapu
132b9d26cd3SPrasad Kummari enum xbl_handoff ret = xbl_handover(&bl32_image_ep_info,
13331ce893eSVenkatesh Yadav Abbarapu &bl33_image_ep_info,
134c8be2240SPrasad Kummari tfa_handoff_addr);
1350ed8b4bfSMaheedhar Bollapalli if ((ret == XBL_HANDOFF_NO_STRUCT) || (ret == XBL_HANDOFF_INVAL_STRUCT)) {
13631ce893eSVenkatesh Yadav Abbarapu bl31_set_default_config();
137b9d26cd3SPrasad Kummari } else if (ret == XBL_HANDOFF_TOO_MANY_PARTS) {
138ea04b3feSVenkatesh Yadav Abbarapu ERROR("BL31: Error too many partitions %u\n", ret);
139b9d26cd3SPrasad Kummari } else if (ret != XBL_HANDOFF_SUCCESS) {
14031ce893eSVenkatesh Yadav Abbarapu panic();
141bc2637e3SAbhyuday Godhasara } else {
1420fe002c9SAkshay Belsare INFO("BL31: PLM to TF-A handover success %u\n", ret);
14331ce893eSVenkatesh Yadav Abbarapu }
144f91c3cb1SSiva Durga Prasad Paladugu
145f91c3cb1SSiva Durga Prasad Paladugu NOTICE("BL31: Secure code at 0x%lx\n", bl32_image_ep_info.pc);
146f91c3cb1SSiva Durga Prasad Paladugu NOTICE("BL31: Non secure code at 0x%lx\n", bl33_image_ep_info.pc);
14772b9f52dSPrasad Kummari
14872b9f52dSPrasad Kummari custom_early_setup();
149f91c3cb1SSiva Durga Prasad Paladugu }
150f91c3cb1SSiva Durga Prasad Paladugu
151e497421dSTanmay Shah static versal_intr_info_type_el3_t type_el3_interrupt_table[MAX_INTR_EL3];
1528b48bfb8SShubhrajyoti Datta
request_intr_type_el3(uint32_t id,interrupt_type_handler_t handler)153e497421dSTanmay Shah int request_intr_type_el3(uint32_t id, interrupt_type_handler_t handler)
1548b48bfb8SShubhrajyoti Datta {
155e497421dSTanmay Shah static uint32_t index;
156e497421dSTanmay Shah uint32_t i;
1575b51d4deSSaivardhan Thatikonda int ret = 0;
158e497421dSTanmay Shah
159e497421dSTanmay Shah /* Validate 'handler' and 'id' parameters */
1600ed8b4bfSMaheedhar Bollapalli if ((handler == NULL) || (index >= MAX_INTR_EL3)) {
161890781d1SMaheedhar Bollapalli ret = -EINVAL;
162890781d1SMaheedhar Bollapalli goto exit_label;
1638b48bfb8SShubhrajyoti Datta }
1648b48bfb8SShubhrajyoti Datta
165e497421dSTanmay Shah /* Check if a handler has already been registered */
166e497421dSTanmay Shah for (i = 0; i < index; i++) {
167e497421dSTanmay Shah if (id == type_el3_interrupt_table[i].id) {
168890781d1SMaheedhar Bollapalli ret = -EALREADY;
169890781d1SMaheedhar Bollapalli goto exit_label;
170e497421dSTanmay Shah }
171e497421dSTanmay Shah }
172e497421dSTanmay Shah
173e497421dSTanmay Shah type_el3_interrupt_table[index].id = id;
174e497421dSTanmay Shah type_el3_interrupt_table[index].handler = handler;
175e497421dSTanmay Shah
176e497421dSTanmay Shah index++;
1778b48bfb8SShubhrajyoti Datta
178890781d1SMaheedhar Bollapalli exit_label:
179890781d1SMaheedhar Bollapalli return ret;
1808b48bfb8SShubhrajyoti Datta }
1818b48bfb8SShubhrajyoti Datta
rdo_el3_interrupt_handler(uint32_t id,uint32_t flags,void * handle,void * cookie)1828b48bfb8SShubhrajyoti Datta static uint64_t rdo_el3_interrupt_handler(uint32_t id, uint32_t flags,
1838b48bfb8SShubhrajyoti Datta void *handle, void *cookie)
1848b48bfb8SShubhrajyoti Datta {
185ab9aab38SMaheedhar Bollapalli (void)id;
1868b48bfb8SShubhrajyoti Datta uint32_t intr_id;
187e497421dSTanmay Shah uint32_t i;
188890781d1SMaheedhar Bollapalli uint64_t ret = 0;
189e497421dSTanmay Shah interrupt_type_handler_t handler = NULL;
1908b48bfb8SShubhrajyoti Datta
1918b48bfb8SShubhrajyoti Datta intr_id = plat_ic_get_pending_interrupt_id();
192e497421dSTanmay Shah
193e497421dSTanmay Shah for (i = 0; i < MAX_INTR_EL3; i++) {
194e497421dSTanmay Shah if (intr_id == type_el3_interrupt_table[i].id) {
195e497421dSTanmay Shah handler = type_el3_interrupt_table[i].handler;
196e497421dSTanmay Shah }
1978b48bfb8SShubhrajyoti Datta }
1988b48bfb8SShubhrajyoti Datta
19968ffcd1bSMichal Simek if (handler != NULL) {
200890781d1SMaheedhar Bollapalli ret = handler(intr_id, flags, handle, cookie);
20168ffcd1bSMichal Simek }
2028b48bfb8SShubhrajyoti Datta
203890781d1SMaheedhar Bollapalli return ret;
2048b48bfb8SShubhrajyoti Datta }
20556d1857eSAmit Nagal
bl31_platform_setup(void)206f91c3cb1SSiva Durga Prasad Paladugu void bl31_platform_setup(void)
207f91c3cb1SSiva Durga Prasad Paladugu {
20856d1857eSAmit Nagal prepare_dtb();
20956d1857eSAmit Nagal
210f91c3cb1SSiva Durga Prasad Paladugu /* Initialize the gic cpu and distributor interfaces */
211f91c3cb1SSiva Durga Prasad Paladugu plat_versal_gic_driver_init();
212f91c3cb1SSiva Durga Prasad Paladugu plat_versal_gic_init();
213f91c3cb1SSiva Durga Prasad Paladugu }
214f91c3cb1SSiva Durga Prasad Paladugu
bl31_plat_runtime_setup(void)215f91c3cb1SSiva Durga Prasad Paladugu void bl31_plat_runtime_setup(void)
216f91c3cb1SSiva Durga Prasad Paladugu {
217*5d8831c2SSaivardhan Thatikonda uint32_t flags = 0;
218b2bb3efbSAbhyuday Godhasara int32_t rc;
2198b48bfb8SShubhrajyoti Datta
2208b48bfb8SShubhrajyoti Datta set_interrupt_rm_flag(flags, NON_SECURE);
2218b48bfb8SShubhrajyoti Datta rc = register_interrupt_type_handler(INTR_TYPE_EL3,
222*5d8831c2SSaivardhan Thatikonda rdo_el3_interrupt_handler, flags);
223a62c40d4SAbhyuday Godhasara if (rc != 0) {
2248b48bfb8SShubhrajyoti Datta panic();
2258b48bfb8SShubhrajyoti Datta }
22672b9f52dSPrasad Kummari
22772b9f52dSPrasad Kummari custom_runtime_setup();
228f91c3cb1SSiva Durga Prasad Paladugu }
229f91c3cb1SSiva Durga Prasad Paladugu
230f91c3cb1SSiva Durga Prasad Paladugu /*
231f91c3cb1SSiva Durga Prasad Paladugu * Perform the very early platform specific architectural setup here.
232f91c3cb1SSiva Durga Prasad Paladugu */
bl31_plat_arch_setup(void)233f91c3cb1SSiva Durga Prasad Paladugu void bl31_plat_arch_setup(void)
234f91c3cb1SSiva Durga Prasad Paladugu {
2355a8ffeabSTejas Patel plat_arm_interconnect_init();
2365a8ffeabSTejas Patel plat_arm_interconnect_enter_coherency();
2375a8ffeabSTejas Patel
238f91c3cb1SSiva Durga Prasad Paladugu const mmap_region_t bl_regions[] = {
2397ca7fb1bSAmit Nagal #if (defined(XILINX_OF_BOARD_DTB_ADDR) && !IS_TFA_IN_OCM(BL31_BASE) && \
2407ca7fb1bSAmit Nagal (!defined(PLAT_XLAT_TABLES_DYNAMIC)))
24156d1857eSAmit Nagal MAP_REGION_FLAT(XILINX_OF_BOARD_DTB_ADDR, XILINX_OF_BOARD_DTB_MAX_SIZE,
24256d1857eSAmit Nagal MT_MEMORY | MT_RW | MT_NS),
24356d1857eSAmit Nagal #endif
244f91c3cb1SSiva Durga Prasad Paladugu MAP_REGION_FLAT(BL31_BASE, BL31_END - BL31_BASE,
245f91c3cb1SSiva Durga Prasad Paladugu MT_MEMORY | MT_RW | MT_SECURE),
246f91c3cb1SSiva Durga Prasad Paladugu MAP_REGION_FLAT(BL_CODE_BASE, BL_CODE_END - BL_CODE_BASE,
247f91c3cb1SSiva Durga Prasad Paladugu MT_CODE | MT_SECURE),
248f91c3cb1SSiva Durga Prasad Paladugu MAP_REGION_FLAT(BL_RO_DATA_BASE, BL_RO_DATA_END - BL_RO_DATA_BASE,
249f91c3cb1SSiva Durga Prasad Paladugu MT_RO_DATA | MT_SECURE),
250f91c3cb1SSiva Durga Prasad Paladugu MAP_REGION_FLAT(BL_COHERENT_RAM_BASE,
251f91c3cb1SSiva Durga Prasad Paladugu BL_COHERENT_RAM_END - BL_COHERENT_RAM_BASE,
252f91c3cb1SSiva Durga Prasad Paladugu MT_DEVICE | MT_RW | MT_SECURE),
253f91c3cb1SSiva Durga Prasad Paladugu {0}
254f91c3cb1SSiva Durga Prasad Paladugu };
255f91c3cb1SSiva Durga Prasad Paladugu
25672b9f52dSPrasad Kummari custom_mmap_add();
25772b9f52dSPrasad Kummari
25851564354SPrasad Kummari setup_page_tables(bl_regions, plat_get_mmap());
2590e9f54e5SMichal Simek enable_mmu(0);
260f91c3cb1SSiva Durga Prasad Paladugu }
261