blob: e024d916df1ab4848e04dc20d918b66c5d6e442f [file] [log] [blame]
Dan Handleyed6ff952014-05-14 17:44:19 +01001/*
Arvind Ram Prakash11b9b492022-11-22 14:41:00 -06002 * Copyright (c) 2013-2023, Arm Limited and Contributors. All rights reserved.
Dan Handleyed6ff952014-05-14 17:44:19 +01003 *
dp-armfa3cf0b2017-05-03 09:38:09 +01004 * SPDX-License-Identifier: BSD-3-Clause
Dan Handleyed6ff952014-05-14 17:44:19 +01005 */
6
Antonio Nino Diazfec756f2018-07-18 16:24:16 +01007#ifndef PLATFORM_H
8#define PLATFORM_H
Dan Handleyed6ff952014-05-14 17:44:19 +01009
10#include <stdint.h>
Dan Handleyed6ff952014-05-14 17:44:19 +010011
Antonio Nino Diaze0f90632018-12-14 00:18:21 +000012#include <lib/psci/psci.h>
Achin Guptada6ef0e2019-10-11 14:54:48 +010013#if defined(SPD_spmd)
AlexeiFedorov8e754f92022-12-14 17:28:11 +000014#include <services/spm_core_manifest.h>
Achin Guptada6ef0e2019-10-11 14:54:48 +010015#endif
Javier Almansa Sobrino4165e842022-04-25 17:18:15 +010016#if ENABLE_RME
17#include <services/rmm_core_manifest.h>
18#endif
Jayanth Dodderi Chidanand7c7faff2022-10-11 17:16:07 +010019#include <drivers/fwu/fwu_metadata.h>
Jimmy Brisson26c5b5c2020-06-22 14:18:42 -050020#if TRNG_SUPPORT
21#include "plat_trng.h"
Jayanth Dodderi Chidanand7c7faff2022-10-11 17:16:07 +010022#endif /* TRNG_SUPPORT */
Lucian Paul-Trifu5ee4f4e2022-06-22 18:45:30 +010023#if DRTM_SUPPORT
24#include "plat_drtm.h"
25#endif /* DRTM_SUPPORT */
Antonio Nino Diaze0f90632018-12-14 00:18:21 +000026
Dan Handleyed6ff952014-05-14 17:44:19 +010027/*******************************************************************************
28 * Forward declarations
29 ******************************************************************************/
dp-armb3e85802016-12-12 14:48:13 +000030struct auth_img_desc_s;
Dan Handleyed6ff952014-05-14 17:44:19 +010031struct meminfo;
32struct image_info;
33struct entry_point_info;
Yatharth Kochara65be2f2015-10-09 18:06:13 +010034struct image_desc;
Yatharth Kochar3345a8d2016-09-12 16:08:41 +010035struct bl_load_info;
36struct bl_params;
Antonio Nino Diazc41f2062017-10-24 10:07:35 +010037struct mmap_region;
Paul Beesley45f40282019-10-15 10:57:42 +000038struct spm_mm_boot_info;
Antonio Nino Diazb86edcb2018-10-30 11:12:42 +000039struct sp_res_desc;
AlexeiFedorov8e754f92022-12-14 17:28:11 +000040struct rmm_manifest;
Sumit Garg617e2152019-11-15 15:34:55 +053041enum fw_enc_status_t;
Dan Handleyed6ff952014-05-14 17:44:19 +010042
43/*******************************************************************************
Juan Castillo31a68f02015-04-14 12:49:03 +010044 * plat_get_rotpk_info() flags
45 ******************************************************************************/
46#define ROTPK_IS_HASH (1 << 0)
Manish V Badarkhee984bc72023-03-10 19:00:02 +000047
Soby Mathew2f7ed052016-05-24 15:05:15 +010048/* Flag used to skip verification of the certificate ROTPK while the platform
49 ROTPK is not deployed */
50#define ROTPK_NOT_DEPLOYED (1 << 1)
Juan Castillo31a68f02015-04-14 12:49:03 +010051
Manish V Badarkhee984bc72023-03-10 19:00:02 +000052static inline bool is_rotpk_flags_valid(unsigned int flags)
53{
54 unsigned int valid_flags = ROTPK_IS_HASH;
55 return (flags == ROTPK_NOT_DEPLOYED) || ((flags & ~valid_flags) == 0);
56}
57
Juan Castillo31a68f02015-04-14 12:49:03 +010058/*******************************************************************************
Sumit Garg392e4df2019-11-15 10:43:00 +053059 * plat_get_enc_key_info() flags
60 ******************************************************************************/
61/*
62 * Flag used to notify caller that information provided in key buffer is an
63 * identifier rather than an actual key.
64 */
65#define ENC_KEY_IS_IDENTIFIER (1 << 0)
66
67/*******************************************************************************
Dan Handley7ce42df2014-05-15 14:11:36 +010068 * Function declarations
Dan Handleyed6ff952014-05-14 17:44:19 +010069 ******************************************************************************/
Dan Handley7ce42df2014-05-15 14:11:36 +010070/*******************************************************************************
71 * Mandatory common functions
72 ******************************************************************************/
Antonio Nino Diaz391a76e2016-05-18 16:53:31 +010073unsigned int plat_get_syscnt_freq2(void);
74
Juan Castillo3a66aca2015-04-13 17:36:19 +010075int plat_get_image_source(unsigned int image_id,
Dan Handley7ce42df2014-05-15 14:11:36 +010076 uintptr_t *dev_handle,
77 uintptr_t *image_spec);
Soby Mathew21f93612016-03-23 10:11:10 +000078uintptr_t plat_get_ns_image_entrypoint(void);
Soby Mathew981487a2015-07-13 14:10:57 +010079unsigned int plat_my_core_pos(void);
80int plat_core_pos_by_mpidr(u_register_t mpidr);
Ambroise Vincentd207f562019-04-10 12:50:27 +010081int plat_get_mbedtls_heap(void **heap_addr, size_t *heap_size);
Dan Handley7ce42df2014-05-15 14:11:36 +010082
Douglas Raillard306593d2017-02-24 18:14:15 +000083#if STACK_PROTECTOR_ENABLED
84/*
85 * Return a new value to be used for the stack protection's canary.
86 *
87 * Ideally, this value is a random number that is impossible to predict by an
88 * attacker.
89 */
90u_register_t plat_get_stack_protector_canary(void);
91#endif /* STACK_PROTECTOR_ENABLED */
92
Dan Handley7ce42df2014-05-15 14:11:36 +010093/*******************************************************************************
94 * Mandatory interrupt management functions
95 ******************************************************************************/
Dan Handley701fea72014-05-27 16:17:21 +010096uint32_t plat_ic_get_pending_interrupt_id(void);
97uint32_t plat_ic_get_pending_interrupt_type(void);
98uint32_t plat_ic_acknowledge_interrupt(void);
99uint32_t plat_ic_get_interrupt_type(uint32_t id);
100void plat_ic_end_of_interrupt(uint32_t id);
Dan Handleyed6ff952014-05-14 17:44:19 +0100101uint32_t plat_interrupt_type_to_line(uint32_t type,
102 uint32_t security_state);
103
Dan Handley7ce42df2014-05-15 14:11:36 +0100104/*******************************************************************************
Jeenu Viswambharanb1e957e2017-09-22 08:32:09 +0100105 * Optional interrupt management functions, depending on chosen EL3 components.
106 ******************************************************************************/
107unsigned int plat_ic_get_running_priority(void);
Jeenu Viswambharan522a4652017-09-22 08:32:09 +0100108int plat_ic_is_spi(unsigned int id);
109int plat_ic_is_ppi(unsigned int id);
110int plat_ic_is_sgi(unsigned int id);
Jeenu Viswambharan24e70292017-09-22 08:32:09 +0100111unsigned int plat_ic_get_interrupt_active(unsigned int id);
Jeenu Viswambharan0fcdfff2017-09-22 08:32:09 +0100112void plat_ic_disable_interrupt(unsigned int id);
113void plat_ic_enable_interrupt(unsigned int id);
Jeenu Viswambharanc06f05c2017-09-22 08:32:09 +0100114int plat_ic_has_interrupt_type(unsigned int type);
115void plat_ic_set_interrupt_type(unsigned int id, unsigned int type);
Jeenu Viswambharan447b89d2017-09-22 08:32:09 +0100116void plat_ic_set_interrupt_priority(unsigned int id, unsigned int priority);
Jeenu Viswambharanab14e9b2017-09-22 08:32:09 +0100117void plat_ic_raise_el3_sgi(int sgi_num, u_register_t target);
Florian Lugoud4e25032021-09-08 12:40:24 +0200118void plat_ic_raise_ns_sgi(int sgi_num, u_register_t target);
119void plat_ic_raise_s_el1_sgi(int sgi_num, u_register_t target);
Jeenu Viswambharandce70b32017-09-22 08:32:09 +0100120void plat_ic_set_spi_routing(unsigned int id, unsigned int routing_mode,
121 u_register_t mpidr);
Jeenu Viswambharaneb1c12c2017-09-22 08:32:09 +0100122void plat_ic_set_interrupt_pending(unsigned int id);
123void plat_ic_clear_interrupt_pending(unsigned int id);
Jeenu Viswambharan62505072017-09-22 08:32:09 +0100124unsigned int plat_ic_set_priority_mask(unsigned int mask);
Jeenu Viswambharan055af4b2017-10-24 15:13:59 +0100125unsigned int plat_ic_get_interrupt_id(unsigned int raw);
Jeenu Viswambharanb1e957e2017-09-22 08:32:09 +0100126
127/*******************************************************************************
Dan Handley7ce42df2014-05-15 14:11:36 +0100128 * Optional common functions (may be overridden)
129 ******************************************************************************/
Soby Mathewa0fedc42016-06-16 14:52:04 +0100130uintptr_t plat_get_my_stack(void);
Yatharth Kocharf528faf2016-06-28 16:58:26 +0100131void plat_report_exception(unsigned int exception_type);
Yann Gautierc1425872019-02-15 16:42:20 +0100132void plat_report_prefetch_abort(unsigned int fault_address);
133void plat_report_data_abort(unsigned int fault_address);
Sandrine Bailleux046cd3f2014-08-06 11:27:23 +0100134int plat_crash_console_init(void);
Soby Mathew066f7132014-07-14 16:57:23 +0100135int plat_crash_console_putc(int c);
Jimmy Brisson39f9eee2020-08-05 13:44:05 -0500136void plat_crash_console_flush(void);
Juan Castillo26ae5832015-09-25 15:41:14 +0100137void plat_error_handler(int err) __dead2;
Antonio Nino Diaz1f21bcf2016-02-01 13:57:25 +0000138void plat_panic_handler(void) __dead2;
Manish V Badarkhefcfe4312022-07-12 21:48:04 +0100139void plat_system_reset(void) __dead2;
Soby Mathewaaf15f52017-09-04 11:49:29 +0100140const char *plat_log_get_prefix(unsigned int log_level);
Roberto Vargasbc1ae1f2017-09-26 12:53:01 +0100141void bl2_plat_preload_setup(void);
142int plat_try_next_boot_source(void);
Dan Handley7ce42df2014-05-15 14:11:36 +0100143
Manish V Badarkhea74d9632021-09-14 23:12:42 +0100144#if MEASURED_BOOT
145int plat_mboot_measure_image(unsigned int image_id, image_info_t *image_data);
Manish V Badarkhe1ffa0092021-10-20 22:06:40 +0100146int plat_mboot_measure_critical_data(unsigned int critical_data_id,
147 const void *base,
148 size_t size);
Manish V Badarkheb2a21602023-04-11 16:12:33 +0100149int plat_mboot_measure_key(const void *pk_oid, const void *pk_ptr,
150 size_t pk_len);
Manish V Badarkhea74d9632021-09-14 23:12:42 +0100151#else
152static inline int plat_mboot_measure_image(unsigned int image_id __unused,
153 image_info_t *image_data __unused)
154{
155 return 0;
156}
Manish V Badarkhe1ffa0092021-10-20 22:06:40 +0100157static inline int plat_mboot_measure_critical_data(
158 unsigned int critical_data_id __unused,
159 const void *base __unused,
160 size_t size __unused)
161{
162 return 0;
163}
Manish V Badarkheb2a21602023-04-11 16:12:33 +0100164static inline int plat_mboot_measure_key(const void *pk_oid __unused,
165 const void *pk_ptr __unused,
166 size_t pk_len __unused)
167{
168 return 0;
169}
Manish V Badarkhea74d9632021-09-14 23:12:42 +0100170#endif /* MEASURED_BOOT */
171
Dan Handley7ce42df2014-05-15 14:11:36 +0100172/*******************************************************************************
173 * Mandatory BL1 functions
174 ******************************************************************************/
Dan Handley4fd2f5c2014-08-04 11:41:20 +0100175void bl1_early_platform_setup(void);
Dan Handley7ce42df2014-05-15 14:11:36 +0100176void bl1_plat_arch_setup(void);
177void bl1_platform_setup(void);
178struct meminfo *bl1_plat_sec_mem_layout(void);
Dan Handleyed6ff952014-05-14 17:44:19 +0100179
Jeenu Viswambharan04e3a7f2017-10-16 08:43:14 +0100180/*******************************************************************************
181 * Optional EL3 component functions in BL31
182 ******************************************************************************/
183
184/* SDEI platform functions */
185#if SDEI_SUPPORT
Balint Dobszayd0dbd5e2019-12-18 15:28:00 +0100186void plat_sdei_setup(void);
Jeenu Viswambharan04e3a7f2017-10-16 08:43:14 +0100187int plat_sdei_validate_entry_point(uintptr_t ep, unsigned int client_mode);
188void plat_sdei_handle_masked_trigger(uint64_t mpidr, unsigned int intr);
189#endif
190
Pali Rohárc36e97f2021-06-21 17:22:27 +0200191void plat_default_ea_handler(unsigned int ea_reason, uint64_t syndrome, void *cookie,
192 void *handle, uint64_t flags);
Jeenu Viswambharan96c7df02017-11-30 12:54:15 +0000193void plat_ea_handler(unsigned int ea_reason, uint64_t syndrome, void *cookie,
194 void *handle, uint64_t flags);
195
Yatharth Kochar71c9a5e2015-10-10 19:06:53 +0100196/*
197 * The following function is mandatory when the
198 * firmware update feature is used.
199 */
200int bl1_plat_mem_check(uintptr_t mem_base, unsigned int mem_size,
201 unsigned int flags);
202
Dan Handley7ce42df2014-05-15 14:11:36 +0100203/*******************************************************************************
204 * Optional BL1 functions (may be overridden)
205 ******************************************************************************/
Yatharth Kochara65be2f2015-10-09 18:06:13 +0100206/*
207 * The following functions are used for image loading process in BL1.
208 */
209void bl1_plat_set_ep_info(unsigned int image_id,
210 struct entry_point_info *ep_info);
Yatharth Kochar71c9a5e2015-10-10 19:06:53 +0100211/*
212 * The following functions are mandatory when firmware update
213 * feature is used and optional otherwise.
214 */
Yatharth Kochara65be2f2015-10-09 18:06:13 +0100215unsigned int bl1_plat_get_next_image_id(void);
216struct image_desc *bl1_plat_get_image_desc(unsigned int image_id);
Dan Handley7ce42df2014-05-15 14:11:36 +0100217
Yatharth Kochar71c9a5e2015-10-10 19:06:53 +0100218/*
219 * The following functions are used by firmware update
220 * feature and may optionally be overridden.
221 */
Dan Handley89f8f332015-12-15 14:28:24 +0000222__dead2 void bl1_plat_fwu_done(void *client_cookie, void *reserved);
Yatharth Kochar71c9a5e2015-10-10 19:06:53 +0100223
Masahiro Yamada43d20b32018-02-01 16:46:18 +0900224/*
Soby Mathew2f38ce32018-02-08 17:45:12 +0000225 * This BL1 function can be used by the platforms to update/use image
226 * information for a given `image_id`.
Masahiro Yamada43d20b32018-02-01 16:46:18 +0900227 */
Soby Mathew2f38ce32018-02-08 17:45:12 +0000228int bl1_plat_handle_pre_image_load(unsigned int image_id);
229int bl1_plat_handle_post_image_load(unsigned int image_id);
Yatharth Kochar71c9a5e2015-10-10 19:06:53 +0100230
Manish V Badarkhea74d9632021-09-14 23:12:42 +0100231#if MEASURED_BOOT
232void bl1_plat_mboot_init(void);
233void bl1_plat_mboot_finish(void);
234#else
235static inline void bl1_plat_mboot_init(void)
236{
237}
238static inline void bl1_plat_mboot_finish(void)
239{
240}
241#endif /* MEASURED_BOOT */
242
Dan Handley7ce42df2014-05-15 14:11:36 +0100243/*******************************************************************************
244 * Mandatory BL2 functions
245 ******************************************************************************/
Soby Mathew73308d02018-01-09 14:36:14 +0000246void bl2_early_platform_setup2(u_register_t arg0, u_register_t arg1, u_register_t arg2, u_register_t arg3);
Dan Handley7ce42df2014-05-15 14:11:36 +0100247void bl2_plat_arch_setup(void);
248void bl2_platform_setup(void);
249struct meminfo *bl2_plat_sec_mem_layout(void);
250
Yatharth Kochar3345a8d2016-09-12 16:08:41 +0100251/*
252 * This function can be used by the platforms to update/use image
253 * information for given `image_id`.
254 */
Masahiro Yamada02a0d3d2018-02-01 16:45:51 +0900255int bl2_plat_handle_pre_image_load(unsigned int image_id);
Yatharth Kochar3345a8d2016-09-12 16:08:41 +0100256int bl2_plat_handle_post_image_load(unsigned int image_id);
257
Sandrine Bailleuxf841ef02014-06-24 14:19:36 +0100258/*******************************************************************************
Dan Handley7ce42df2014-05-15 14:11:36 +0100259 * Optional BL2 functions (may be overridden)
260 ******************************************************************************/
Alexei Fedorovc7176172020-07-13 12:11:05 +0100261#if MEASURED_BOOT
Manish V Badarkhe5797b802021-08-06 09:26:20 +0100262void bl2_plat_mboot_init(void);
263void bl2_plat_mboot_finish(void);
264#else
265static inline void bl2_plat_mboot_init(void)
266{
267}
268static inline void bl2_plat_mboot_finish(void)
269{
Manish V Badarkhe57b669f2021-09-20 09:06:02 +0100270}
Manish V Badarkhe5797b802021-08-06 09:26:20 +0100271#endif /* MEASURED_BOOT */
Roberto Vargase0e99462017-10-30 14:43:43 +0000272
273/*******************************************************************************
Arvind Ram Prakash11b9b492022-11-22 14:41:00 -0600274 * Mandatory BL2 at EL3 functions: Must be implemented
275 * if RESET_TO_BL2 image is supported
Roberto Vargase0e99462017-10-30 14:43:43 +0000276 ******************************************************************************/
277void bl2_el3_early_platform_setup(u_register_t arg0, u_register_t arg1,
278 u_register_t arg2, u_register_t arg3);
279void bl2_el3_plat_arch_setup(void);
280
Roberto Vargase0e99462017-10-30 14:43:43 +0000281/*******************************************************************************
282 * Optional BL2 at EL3 functions (may be overridden)
283 ******************************************************************************/
284void bl2_el3_plat_prepare_exit(void);
285
Dan Handley7ce42df2014-05-15 14:11:36 +0100286/*******************************************************************************
Yatharth Kocharb1c2fe02015-10-14 15:27:24 +0100287 * Mandatory BL2U functions.
288 ******************************************************************************/
289void bl2u_early_platform_setup(struct meminfo *mem_layout,
290 void *plat_info);
291void bl2u_plat_arch_setup(void);
292void bl2u_platform_setup(void);
293
294/*******************************************************************************
295 * Conditionally mandatory BL2U functions for CSS platforms.
296 ******************************************************************************/
297/*
298 * This function is used to perform any platform-specific actions required to
299 * handle the BL2U_SCP firmware.
300 */
301int bl2u_plat_handle_scp_bl2u(void);
302
303/*******************************************************************************
Juan Castillo7d199412015-12-14 09:35:25 +0000304 * Mandatory BL31 functions
Dan Handley7ce42df2014-05-15 14:11:36 +0100305 ******************************************************************************/
Soby Mathew73308d02018-01-09 14:36:14 +0000306void bl31_early_platform_setup2(u_register_t arg0, u_register_t arg1,
307 u_register_t arg2, u_register_t arg3);
Dan Handley7ce42df2014-05-15 14:11:36 +0100308void bl31_plat_arch_setup(void);
309void bl31_platform_setup(void);
Soby Mathew1ff495b2015-12-09 11:28:43 +0000310void bl31_plat_runtime_setup(void);
Dan Handley701fea72014-05-27 16:17:21 +0100311struct entry_point_info *bl31_plat_get_next_image_ep_info(uint32_t type);
Dan Handley7ce42df2014-05-15 14:11:36 +0100312
313/*******************************************************************************
Juan Castillo7d199412015-12-14 09:35:25 +0000314 * Mandatory PSCI functions (BL31)
Dan Handley7ce42df2014-05-15 14:11:36 +0100315 ******************************************************************************/
Soby Mathew981487a2015-07-13 14:10:57 +0100316int plat_setup_psci_ops(uintptr_t sec_entrypoint,
Roberto Vargas777dd432018-02-12 12:36:17 +0000317 const struct plat_psci_ops **psci_ops);
Soby Mathew981487a2015-07-13 14:10:57 +0100318const unsigned char *plat_get_power_domain_tree_desc(void);
319
320/*******************************************************************************
Juan Castillo7d199412015-12-14 09:35:25 +0000321 * Optional PSCI functions (BL31).
Soby Mathew981487a2015-07-13 14:10:57 +0100322 ******************************************************************************/
dp-arm66abfbe2017-01-31 13:01:04 +0000323void plat_psci_stat_accounting_start(const psci_power_state_t *state_info);
324void plat_psci_stat_accounting_stop(const psci_power_state_t *state_info);
325u_register_t plat_psci_stat_get_residency(unsigned int lvl,
326 const psci_power_state_t *state_info,
Deepika Bhavnani4287c0c2019-12-13 10:23:18 -0600327 unsigned int last_cpu_idx);
Soby Mathew981487a2015-07-13 14:10:57 +0100328plat_local_state_t plat_get_target_pwr_state(unsigned int lvl,
329 const plat_local_state_t *states,
330 unsigned int ncpu);
Dan Handley7ce42df2014-05-15 14:11:36 +0100331
332/*******************************************************************************
Soby Mathew294e1cf2022-03-22 16:19:39 +0000333 * Mandatory BL31 functions when ENABLE_RME=1
334 ******************************************************************************/
Javier Almansa Sobrino4165e842022-04-25 17:18:15 +0100335#if ENABLE_RME
Javier Almansa Sobrino7176a772021-11-24 18:37:37 +0000336int plat_rmmd_get_cca_attest_token(uintptr_t buf, size_t *len,
337 uintptr_t hash, size_t hash_size);
338int plat_rmmd_get_cca_realm_attest_key(uintptr_t buf, size_t *len,
339 unsigned int type);
340size_t plat_rmmd_get_el3_rmm_shared_mem(uintptr_t *shared);
AlexeiFedorov8e754f92022-12-14 17:28:11 +0000341int plat_rmmd_load_manifest(struct rmm_manifest *manifest);
Javier Almansa Sobrino4165e842022-04-25 17:18:15 +0100342#endif
343
Soby Mathew294e1cf2022-03-22 16:19:39 +0000344/*******************************************************************************
Juan Castillo7d199412015-12-14 09:35:25 +0000345 * Optional BL31 functions (may be overridden)
Dan Handleyb226a4d2014-05-16 14:08:45 +0100346 ******************************************************************************/
Achin Guptae9982542014-06-26 08:59:07 +0100347void bl31_plat_enable_mmu(uint32_t flags);
Dan Handleyb226a4d2014-05-16 14:08:45 +0100348
349/*******************************************************************************
Juan Castillo7d199412015-12-14 09:35:25 +0000350 * Optional BL32 functions (may be overridden)
Dan Handleyb226a4d2014-05-16 14:08:45 +0100351 ******************************************************************************/
Achin Guptae9982542014-06-26 08:59:07 +0100352void bl32_plat_enable_mmu(uint32_t flags);
Dan Handleyb226a4d2014-05-16 14:08:45 +0100353
Juan Castillo5e29c752015-01-07 10:39:25 +0000354/*******************************************************************************
Juan Castillo31a68f02015-04-14 12:49:03 +0100355 * Trusted Board Boot functions
Juan Castillo5e29c752015-01-07 10:39:25 +0000356 ******************************************************************************/
Juan Castillo31a68f02015-04-14 12:49:03 +0100357int plat_get_rotpk_info(void *cookie, void **key_ptr, unsigned int *key_len,
358 unsigned int *flags);
Juan Castillobfb7fa62016-01-22 11:05:57 +0000359int plat_get_nv_ctr(void *cookie, unsigned int *nv_ctr);
360int plat_set_nv_ctr(void *cookie, unsigned int nv_ctr);
dp-armb3e85802016-12-12 14:48:13 +0000361int plat_set_nv_ctr2(void *cookie, const struct auth_img_desc_s *img_desc,
362 unsigned int nv_ctr);
Ambroise Vincentd207f562019-04-10 12:50:27 +0100363int get_mbedtls_heap_helper(void **heap_addr, size_t *heap_size);
Sumit Garg617e2152019-11-15 15:34:55 +0530364int plat_get_enc_key_info(enum fw_enc_status_t fw_enc_status, uint8_t *key,
365 size_t *key_len, unsigned int *flags,
366 const uint8_t *img_id, size_t img_id_len);
Juan Castillo5e29c752015-01-07 10:39:25 +0000367
Antonio Nino Diazc41f2062017-10-24 10:07:35 +0100368/*******************************************************************************
369 * Secure Partitions functions
370 ******************************************************************************/
371const struct mmap_region *plat_get_secure_partition_mmap(void *cookie);
Paul Beesley45f40282019-10-15 10:57:42 +0000372const struct spm_mm_boot_info *plat_get_secure_partition_boot_info(
Antonio Nino Diazc41f2062017-10-24 10:07:35 +0100373 void *cookie);
Antonio Nino Diazb86edcb2018-10-30 11:12:42 +0000374int plat_spm_sp_rd_load(struct sp_res_desc *rd, const void *ptr, size_t size);
Antonio Nino Diaz840627f2018-11-27 08:36:02 +0000375int plat_spm_sp_get_next_address(void **sp_base, size_t *sp_size,
376 void **rd_base, size_t *rd_size);
Achin Guptada6ef0e2019-10-11 14:54:48 +0100377#if defined(SPD_spmd)
Olivier Deprez2bae35f2020-04-16 13:39:06 +0200378int plat_spm_core_manifest_load(spmc_manifest_attribute_t *manifest,
Olivier Deprez69ca84a2020-02-07 15:44:43 +0100379 const void *pm_addr);
Achin Guptada6ef0e2019-10-11 14:54:48 +0100380#endif
Marc Bonnicic66fc1b2021-12-16 18:31:02 +0000381#if defined(SPMC_AT_EL3)
382int plat_spmc_shmem_datastore_get(uint8_t **datastore, size_t *size);
383#endif
384
Yatharth Kochar3345a8d2016-09-12 16:08:41 +0100385/*******************************************************************************
386 * Mandatory BL image load functions(may be overridden).
387 ******************************************************************************/
388/*
389 * This function returns pointer to the list of images that the
390 * platform has populated to load.
391 */
392struct bl_load_info *plat_get_bl_image_load_info(void);
393
394/*
395 * This function returns a pointer to the shared memory that the
396 * platform has kept aside to pass trusted firmware related
397 * information that next BL image could need.
398 */
399struct bl_params *plat_get_next_bl_params(void);
400
401/*
402 * This function flushes to main memory all the params that are
403 * passed to next image.
404 */
405void plat_flush_next_bl_params(void);
406
Soby Mathew70716d62015-07-13 16:26:11 +0100407/*
408 * The below function enable Trusted Firmware components like SPDs which
409 * haven't migrated to the new platform API to compile on platforms which
410 * have the compatibility layer disabled.
411 */
Roberto Vargas05712702018-02-12 12:36:17 +0000412unsigned int platform_core_pos_helper(unsigned long mpidr);
Douglas Raillard306593d2017-02-24 18:14:15 +0000413
Manish V Badarkhef809c6e2020-02-22 08:43:00 +0000414/*
415 * Optional function to get SOC version
416 */
417int32_t plat_get_soc_version(void);
418
419/*
420 * Optional function to get SOC revision
421 */
422int32_t plat_get_soc_revision(void);
423
Manish V Badarkhe80f13ee2020-07-23 20:23:01 +0100424/*
425 * Optional function to check for SMCCC function availability for platform
426 */
427int32_t plat_is_smccc_feature_available(u_register_t fid);
428
Manish V Badarkhea040b642021-06-20 21:04:49 +0100429/*******************************************************************************
430 * FWU platform specific functions
431 ******************************************************************************/
432int plat_fwu_set_metadata_image_source(unsigned int image_id,
433 uintptr_t *dev_handle,
434 uintptr_t *image_spec);
Sughosh Ganuf40154f2021-11-17 17:08:10 +0530435void plat_fwu_set_images_source(const struct fwu_metadata *metadata);
Sughosh Ganu4e336a62021-12-01 15:53:32 +0530436uint32_t plat_fwu_get_boot_idx(void);
Manish V Badarkhea040b642021-06-20 21:04:49 +0100437
Channagoud kadabia037d972022-11-29 16:03:47 -0800438/*
439 * Optional function to indicate if cache management operations can be
440 * performed.
441 */
442#if CONDITIONAL_CMO
443uint64_t plat_can_cmo(void);
444#else
445static inline uint64_t plat_can_cmo(void)
446{
447 return 1;
448}
449#endif /* CONDITIONAL_CMO */
450
Antonio Nino Diazfec756f2018-07-18 16:24:16 +0100451#endif /* PLATFORM_H */