xref: /aosp_15_r20/external/arm-trusted-firmware/plat/common/plat_bl_common.c (revision 54fd6939e177f8ff529b10183254802c76df6d08)
1*54fd6939SJiyong Park /*
2*54fd6939SJiyong Park  * Copyright (c) 2018-2020, ARM Limited and Contributors. All rights reserved.
3*54fd6939SJiyong Park  *
4*54fd6939SJiyong Park  * SPDX-License-Identifier: BSD-3-Clause
5*54fd6939SJiyong Park  */
6*54fd6939SJiyong Park 
7*54fd6939SJiyong Park #include <assert.h>
8*54fd6939SJiyong Park 
9*54fd6939SJiyong Park #include <arch_helpers.h>
10*54fd6939SJiyong Park #include <common/bl_common.h>
11*54fd6939SJiyong Park #include <common/debug.h>
12*54fd6939SJiyong Park #include <lib/xlat_tables/xlat_tables_compat.h>
13*54fd6939SJiyong Park #include <plat/common/platform.h>
14*54fd6939SJiyong Park #include <services/arm_arch_svc.h>
15*54fd6939SJiyong Park #include <smccc_helpers.h>
16*54fd6939SJiyong Park #include <tools_share/firmware_encrypted.h>
17*54fd6939SJiyong Park 
18*54fd6939SJiyong Park /*
19*54fd6939SJiyong Park  * The following platform functions are weakly defined. The Platforms
20*54fd6939SJiyong Park  * may redefine with strong definition.
21*54fd6939SJiyong Park  */
22*54fd6939SJiyong Park #pragma weak bl2_el3_plat_prepare_exit
23*54fd6939SJiyong Park #pragma weak plat_error_handler
24*54fd6939SJiyong Park #pragma weak bl2_plat_preload_setup
25*54fd6939SJiyong Park #pragma weak bl2_plat_handle_pre_image_load
26*54fd6939SJiyong Park #pragma weak bl2_plat_handle_post_image_load
27*54fd6939SJiyong Park #pragma weak plat_try_next_boot_source
28*54fd6939SJiyong Park #pragma weak plat_get_enc_key_info
29*54fd6939SJiyong Park #pragma weak plat_is_smccc_feature_available
30*54fd6939SJiyong Park #pragma weak plat_get_soc_version
31*54fd6939SJiyong Park #pragma weak plat_get_soc_revision
32*54fd6939SJiyong Park 
plat_get_soc_version(void)33*54fd6939SJiyong Park int32_t plat_get_soc_version(void)
34*54fd6939SJiyong Park {
35*54fd6939SJiyong Park 	return SMC_ARCH_CALL_NOT_SUPPORTED;
36*54fd6939SJiyong Park }
37*54fd6939SJiyong Park 
plat_get_soc_revision(void)38*54fd6939SJiyong Park int32_t plat_get_soc_revision(void)
39*54fd6939SJiyong Park {
40*54fd6939SJiyong Park 	return SMC_ARCH_CALL_NOT_SUPPORTED;
41*54fd6939SJiyong Park }
42*54fd6939SJiyong Park 
plat_is_smccc_feature_available(u_register_t fid __unused)43*54fd6939SJiyong Park int32_t plat_is_smccc_feature_available(u_register_t fid __unused)
44*54fd6939SJiyong Park {
45*54fd6939SJiyong Park 	return SMC_ARCH_CALL_NOT_SUPPORTED;
46*54fd6939SJiyong Park }
47*54fd6939SJiyong Park 
bl2_el3_plat_prepare_exit(void)48*54fd6939SJiyong Park void bl2_el3_plat_prepare_exit(void)
49*54fd6939SJiyong Park {
50*54fd6939SJiyong Park }
51*54fd6939SJiyong Park 
plat_error_handler(int err)52*54fd6939SJiyong Park void __dead2 plat_error_handler(int err)
53*54fd6939SJiyong Park {
54*54fd6939SJiyong Park 	while (1)
55*54fd6939SJiyong Park 		wfi();
56*54fd6939SJiyong Park }
57*54fd6939SJiyong Park 
bl2_plat_preload_setup(void)58*54fd6939SJiyong Park void bl2_plat_preload_setup(void)
59*54fd6939SJiyong Park {
60*54fd6939SJiyong Park }
61*54fd6939SJiyong Park 
bl2_plat_handle_pre_image_load(unsigned int image_id)62*54fd6939SJiyong Park int bl2_plat_handle_pre_image_load(unsigned int image_id)
63*54fd6939SJiyong Park {
64*54fd6939SJiyong Park 	return 0;
65*54fd6939SJiyong Park }
66*54fd6939SJiyong Park 
bl2_plat_handle_post_image_load(unsigned int image_id)67*54fd6939SJiyong Park int bl2_plat_handle_post_image_load(unsigned int image_id)
68*54fd6939SJiyong Park {
69*54fd6939SJiyong Park 	return 0;
70*54fd6939SJiyong Park }
71*54fd6939SJiyong Park 
plat_try_next_boot_source(void)72*54fd6939SJiyong Park int plat_try_next_boot_source(void)
73*54fd6939SJiyong Park {
74*54fd6939SJiyong Park 	return 0;
75*54fd6939SJiyong Park }
76*54fd6939SJiyong Park 
77*54fd6939SJiyong Park /*
78*54fd6939SJiyong Park  * Weak implementation to provide dummy decryption key only for test purposes,
79*54fd6939SJiyong Park  * platforms must override this API for any real world firmware encryption
80*54fd6939SJiyong Park  * use-case.
81*54fd6939SJiyong Park  */
plat_get_enc_key_info(enum fw_enc_status_t fw_enc_status,uint8_t * key,size_t * key_len,unsigned int * flags,const uint8_t * img_id,size_t img_id_len)82*54fd6939SJiyong Park int plat_get_enc_key_info(enum fw_enc_status_t fw_enc_status, uint8_t *key,
83*54fd6939SJiyong Park 			  size_t *key_len, unsigned int *flags,
84*54fd6939SJiyong Park 			  const uint8_t *img_id, size_t img_id_len)
85*54fd6939SJiyong Park {
86*54fd6939SJiyong Park #define DUMMY_FIP_ENC_KEY { 0x12, 0x34, 0x56, 0x78, 0x90, 0xab, 0xcd, 0xef, \
87*54fd6939SJiyong Park 			    0x12, 0x34, 0x56, 0x78, 0x90, 0xab, 0xcd, 0xef, \
88*54fd6939SJiyong Park 			    0x12, 0x34, 0x56, 0x78, 0x90, 0xab, 0xcd, 0xef, \
89*54fd6939SJiyong Park 			    0x12, 0x34, 0x56, 0x78, 0x90, 0xab, 0xcd, 0xef }
90*54fd6939SJiyong Park 
91*54fd6939SJiyong Park 	const uint8_t dummy_key[] = DUMMY_FIP_ENC_KEY;
92*54fd6939SJiyong Park 
93*54fd6939SJiyong Park 	assert(*key_len >= sizeof(dummy_key));
94*54fd6939SJiyong Park 
95*54fd6939SJiyong Park 	*key_len = sizeof(dummy_key);
96*54fd6939SJiyong Park 	memcpy(key, dummy_key, *key_len);
97*54fd6939SJiyong Park 	*flags = 0;
98*54fd6939SJiyong Park 
99*54fd6939SJiyong Park 	return 0;
100*54fd6939SJiyong Park }
101*54fd6939SJiyong Park 
102*54fd6939SJiyong Park /*
103*54fd6939SJiyong Park  * Set up the page tables for the generic and platform-specific memory regions.
104*54fd6939SJiyong Park  * The size of the Trusted SRAM seen by the BL image must be specified as well
105*54fd6939SJiyong Park  * as an array specifying the generic memory regions which can be;
106*54fd6939SJiyong Park  * - Code section;
107*54fd6939SJiyong Park  * - Read-only data section;
108*54fd6939SJiyong Park  * - Init code section, if applicable
109*54fd6939SJiyong Park  * - Coherent memory region, if applicable.
110*54fd6939SJiyong Park  */
111*54fd6939SJiyong Park 
setup_page_tables(const mmap_region_t * bl_regions,const mmap_region_t * plat_regions)112*54fd6939SJiyong Park void __init setup_page_tables(const mmap_region_t *bl_regions,
113*54fd6939SJiyong Park 			      const mmap_region_t *plat_regions)
114*54fd6939SJiyong Park {
115*54fd6939SJiyong Park #if LOG_LEVEL >= LOG_LEVEL_VERBOSE
116*54fd6939SJiyong Park 	const mmap_region_t *regions = bl_regions;
117*54fd6939SJiyong Park 
118*54fd6939SJiyong Park 	while (regions->size != 0U) {
119*54fd6939SJiyong Park 		VERBOSE("Region: 0x%lx - 0x%lx has attributes 0x%x\n",
120*54fd6939SJiyong Park 				regions->base_va,
121*54fd6939SJiyong Park 				regions->base_va + regions->size,
122*54fd6939SJiyong Park 				regions->attr);
123*54fd6939SJiyong Park 		regions++;
124*54fd6939SJiyong Park 	}
125*54fd6939SJiyong Park #endif
126*54fd6939SJiyong Park 	/*
127*54fd6939SJiyong Park 	 * Map the Trusted SRAM with appropriate memory attributes.
128*54fd6939SJiyong Park 	 * Subsequent mappings will adjust the attributes for specific regions.
129*54fd6939SJiyong Park 	 */
130*54fd6939SJiyong Park 	mmap_add(bl_regions);
131*54fd6939SJiyong Park 
132*54fd6939SJiyong Park 	/* Now (re-)map the platform-specific memory regions */
133*54fd6939SJiyong Park 	mmap_add(plat_regions);
134*54fd6939SJiyong Park 
135*54fd6939SJiyong Park 	/* Create the page tables to reflect the above mappings */
136*54fd6939SJiyong Park 	init_xlat_tables();
137*54fd6939SJiyong Park }
138