blob: 12eac60bea9eca7e8b54be8ff1d5c1402b82cbcc [file] [log] [blame]
Dan Handleyed6ff952014-05-14 17:44:19 +01001/*
Masahiro Yamada02a0d3d2018-02-01 16:45:51 +09002 * Copyright (c) 2013-2018, 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
Soby Mathew981487a2015-07-13 14:10:57 +010010#include <psci.h>
Dan Handleyed6ff952014-05-14 17:44:19 +010011#include <stdint.h>
Soby Mathew981487a2015-07-13 14:10:57 +010012#include <types.h>
Dan Handleyed6ff952014-05-14 17:44:19 +010013
14
15/*******************************************************************************
16 * Forward declarations
17 ******************************************************************************/
dp-armb3e85802016-12-12 14:48:13 +000018struct auth_img_desc_s;
Dan Handleyed6ff952014-05-14 17:44:19 +010019struct meminfo;
20struct image_info;
21struct entry_point_info;
Dan Handley7ce42df2014-05-15 14:11:36 +010022struct bl31_params;
Yatharth Kochara65be2f2015-10-09 18:06:13 +010023struct image_desc;
Yatharth Kochar3345a8d2016-09-12 16:08:41 +010024struct bl_load_info;
25struct bl_params;
Antonio Nino Diazc41f2062017-10-24 10:07:35 +010026struct mmap_region;
27struct secure_partition_boot_info;
Dan Handleyed6ff952014-05-14 17:44:19 +010028
29/*******************************************************************************
Juan Castillo31a68f02015-04-14 12:49:03 +010030 * plat_get_rotpk_info() flags
31 ******************************************************************************/
32#define ROTPK_IS_HASH (1 << 0)
Soby Mathew2f7ed052016-05-24 15:05:15 +010033/* Flag used to skip verification of the certificate ROTPK while the platform
34 ROTPK is not deployed */
35#define ROTPK_NOT_DEPLOYED (1 << 1)
Juan Castillo31a68f02015-04-14 12:49:03 +010036
37/*******************************************************************************
Dan Handley7ce42df2014-05-15 14:11:36 +010038 * Function declarations
Dan Handleyed6ff952014-05-14 17:44:19 +010039 ******************************************************************************/
Dan Handley7ce42df2014-05-15 14:11:36 +010040/*******************************************************************************
41 * Mandatory common functions
42 ******************************************************************************/
Antonio Nino Diaz391a76e2016-05-18 16:53:31 +010043unsigned long long plat_get_syscnt_freq(void) __deprecated;
44unsigned int plat_get_syscnt_freq2(void);
45
Juan Castillo3a66aca2015-04-13 17:36:19 +010046int plat_get_image_source(unsigned int image_id,
Dan Handley7ce42df2014-05-15 14:11:36 +010047 uintptr_t *dev_handle,
48 uintptr_t *image_spec);
Soby Mathew21f93612016-03-23 10:11:10 +000049uintptr_t plat_get_ns_image_entrypoint(void);
Soby Mathew981487a2015-07-13 14:10:57 +010050unsigned int plat_my_core_pos(void);
51int plat_core_pos_by_mpidr(u_register_t mpidr);
Dan Handley7ce42df2014-05-15 14:11:36 +010052
Douglas Raillard306593d2017-02-24 18:14:15 +000053#if STACK_PROTECTOR_ENABLED
54/*
55 * Return a new value to be used for the stack protection's canary.
56 *
57 * Ideally, this value is a random number that is impossible to predict by an
58 * attacker.
59 */
60u_register_t plat_get_stack_protector_canary(void);
61#endif /* STACK_PROTECTOR_ENABLED */
62
Dan Handley7ce42df2014-05-15 14:11:36 +010063/*******************************************************************************
64 * Mandatory interrupt management functions
65 ******************************************************************************/
Dan Handley701fea72014-05-27 16:17:21 +010066uint32_t plat_ic_get_pending_interrupt_id(void);
67uint32_t plat_ic_get_pending_interrupt_type(void);
68uint32_t plat_ic_acknowledge_interrupt(void);
69uint32_t plat_ic_get_interrupt_type(uint32_t id);
70void plat_ic_end_of_interrupt(uint32_t id);
Dan Handleyed6ff952014-05-14 17:44:19 +010071uint32_t plat_interrupt_type_to_line(uint32_t type,
72 uint32_t security_state);
73
Dan Handley7ce42df2014-05-15 14:11:36 +010074/*******************************************************************************
Jeenu Viswambharanb1e957e2017-09-22 08:32:09 +010075 * Optional interrupt management functions, depending on chosen EL3 components.
76 ******************************************************************************/
77unsigned int plat_ic_get_running_priority(void);
Jeenu Viswambharan522a4652017-09-22 08:32:09 +010078int plat_ic_is_spi(unsigned int id);
79int plat_ic_is_ppi(unsigned int id);
80int plat_ic_is_sgi(unsigned int id);
Jeenu Viswambharan24e70292017-09-22 08:32:09 +010081unsigned int plat_ic_get_interrupt_active(unsigned int id);
Jeenu Viswambharan0fcdfff2017-09-22 08:32:09 +010082void plat_ic_disable_interrupt(unsigned int id);
83void plat_ic_enable_interrupt(unsigned int id);
Jeenu Viswambharanc06f05c2017-09-22 08:32:09 +010084int plat_ic_has_interrupt_type(unsigned int type);
85void plat_ic_set_interrupt_type(unsigned int id, unsigned int type);
Jeenu Viswambharan447b89d2017-09-22 08:32:09 +010086void plat_ic_set_interrupt_priority(unsigned int id, unsigned int priority);
Jeenu Viswambharanab14e9b2017-09-22 08:32:09 +010087void plat_ic_raise_el3_sgi(int sgi_num, u_register_t target);
Jeenu Viswambharandce70b32017-09-22 08:32:09 +010088void plat_ic_set_spi_routing(unsigned int id, unsigned int routing_mode,
89 u_register_t mpidr);
Jeenu Viswambharaneb1c12c2017-09-22 08:32:09 +010090void plat_ic_set_interrupt_pending(unsigned int id);
91void plat_ic_clear_interrupt_pending(unsigned int id);
Jeenu Viswambharan62505072017-09-22 08:32:09 +010092unsigned int plat_ic_set_priority_mask(unsigned int mask);
Jeenu Viswambharan055af4b2017-10-24 15:13:59 +010093unsigned int plat_ic_get_interrupt_id(unsigned int raw);
Jeenu Viswambharanb1e957e2017-09-22 08:32:09 +010094
95/*******************************************************************************
Dan Handley7ce42df2014-05-15 14:11:36 +010096 * Optional common functions (may be overridden)
97 ******************************************************************************/
Soby Mathewa0fedc42016-06-16 14:52:04 +010098uintptr_t plat_get_my_stack(void);
Yatharth Kocharf528faf2016-06-28 16:58:26 +010099void plat_report_exception(unsigned int exception_type);
Sandrine Bailleux046cd3f2014-08-06 11:27:23 +0100100int plat_crash_console_init(void);
Soby Mathew066f7132014-07-14 16:57:23 +0100101int plat_crash_console_putc(int c);
Antonio Nino Diazd3ec5432017-02-17 17:11:27 +0000102int plat_crash_console_flush(void);
Juan Castillo26ae5832015-09-25 15:41:14 +0100103void plat_error_handler(int err) __dead2;
Antonio Nino Diaz1f21bcf2016-02-01 13:57:25 +0000104void plat_panic_handler(void) __dead2;
Soby Mathewaaf15f52017-09-04 11:49:29 +0100105const char *plat_log_get_prefix(unsigned int log_level);
Roberto Vargasbc1ae1f2017-09-26 12:53:01 +0100106void bl2_plat_preload_setup(void);
107int plat_try_next_boot_source(void);
Dan Handley7ce42df2014-05-15 14:11:36 +0100108
109/*******************************************************************************
110 * Mandatory BL1 functions
111 ******************************************************************************/
Dan Handley4fd2f5c2014-08-04 11:41:20 +0100112void bl1_early_platform_setup(void);
Dan Handley7ce42df2014-05-15 14:11:36 +0100113void bl1_plat_arch_setup(void);
114void bl1_platform_setup(void);
115struct meminfo *bl1_plat_sec_mem_layout(void);
Dan Handleyed6ff952014-05-14 17:44:19 +0100116
Jeenu Viswambharan04e3a7f2017-10-16 08:43:14 +0100117/*******************************************************************************
118 * Optional EL3 component functions in BL31
119 ******************************************************************************/
120
121/* SDEI platform functions */
122#if SDEI_SUPPORT
123int plat_sdei_validate_entry_point(uintptr_t ep, unsigned int client_mode);
124void plat_sdei_handle_masked_trigger(uint64_t mpidr, unsigned int intr);
125#endif
126
Jeenu Viswambharan96c7df02017-11-30 12:54:15 +0000127void plat_ea_handler(unsigned int ea_reason, uint64_t syndrome, void *cookie,
128 void *handle, uint64_t flags);
129
Yatharth Kochar71c9a5e2015-10-10 19:06:53 +0100130/*
131 * The following function is mandatory when the
132 * firmware update feature is used.
133 */
134int bl1_plat_mem_check(uintptr_t mem_base, unsigned int mem_size,
135 unsigned int flags);
136
Dan Handley7ce42df2014-05-15 14:11:36 +0100137/*******************************************************************************
138 * Optional BL1 functions (may be overridden)
139 ******************************************************************************/
Soby Mathew6e16a332018-01-10 12:51:34 +0000140#if !ERROR_DEPRECATED
Sandrine Bailleux467d0572014-06-24 14:02:34 +0100141void bl1_init_bl2_mem_layout(const struct meminfo *bl1_mem_layout,
142 struct meminfo *bl2_mem_layout);
Soby Mathew6e16a332018-01-10 12:51:34 +0000143#endif
Yatharth Kochara65be2f2015-10-09 18:06:13 +0100144/*
145 * The following functions are used for image loading process in BL1.
146 */
147void bl1_plat_set_ep_info(unsigned int image_id,
148 struct entry_point_info *ep_info);
Yatharth Kochar71c9a5e2015-10-10 19:06:53 +0100149/*
150 * The following functions are mandatory when firmware update
151 * feature is used and optional otherwise.
152 */
Yatharth Kochara65be2f2015-10-09 18:06:13 +0100153unsigned int bl1_plat_get_next_image_id(void);
154struct image_desc *bl1_plat_get_image_desc(unsigned int image_id);
Dan Handley7ce42df2014-05-15 14:11:36 +0100155
Yatharth Kochar71c9a5e2015-10-10 19:06:53 +0100156/*
157 * The following functions are used by firmware update
158 * feature and may optionally be overridden.
159 */
Dan Handley89f8f332015-12-15 14:28:24 +0000160__dead2 void bl1_plat_fwu_done(void *client_cookie, void *reserved);
Yatharth Kochar71c9a5e2015-10-10 19:06:53 +0100161
Masahiro Yamada43d20b32018-02-01 16:46:18 +0900162/*
Soby Mathew2f38ce32018-02-08 17:45:12 +0000163 * This BL1 function can be used by the platforms to update/use image
164 * information for a given `image_id`.
Masahiro Yamada43d20b32018-02-01 16:46:18 +0900165 */
Soby Mathew2f38ce32018-02-08 17:45:12 +0000166int bl1_plat_handle_pre_image_load(unsigned int image_id);
167int bl1_plat_handle_post_image_load(unsigned int image_id);
Yatharth Kochar71c9a5e2015-10-10 19:06:53 +0100168
Dan Handley7ce42df2014-05-15 14:11:36 +0100169/*******************************************************************************
170 * Mandatory BL2 functions
171 ******************************************************************************/
Soby Mathew73308d02018-01-09 14:36:14 +0000172void bl2_early_platform_setup2(u_register_t arg0, u_register_t arg1, u_register_t arg2, u_register_t arg3);
173#if !ERROR_DEPRECATED
Dan Handley4fd2f5c2014-08-04 11:41:20 +0100174void bl2_early_platform_setup(struct meminfo *mem_layout);
Soby Mathew73308d02018-01-09 14:36:14 +0000175#endif
Dan Handley7ce42df2014-05-15 14:11:36 +0100176void bl2_plat_arch_setup(void);
177void bl2_platform_setup(void);
178struct meminfo *bl2_plat_sec_mem_layout(void);
179
Yatharth Kochar3345a8d2016-09-12 16:08:41 +0100180#if LOAD_IMAGE_V2
181/*
182 * This function can be used by the platforms to update/use image
183 * information for given `image_id`.
184 */
Masahiro Yamada02a0d3d2018-02-01 16:45:51 +0900185int bl2_plat_handle_pre_image_load(unsigned int image_id);
Yatharth Kochar3345a8d2016-09-12 16:08:41 +0100186int bl2_plat_handle_post_image_load(unsigned int image_id);
187
188#else /* LOAD_IMAGE_V2 */
189
Dan Handley7ce42df2014-05-15 14:11:36 +0100190/*
191 * This function returns a pointer to the shared memory that the platform has
Juan Castillo7d199412015-12-14 09:35:25 +0000192 * kept aside to pass trusted firmware related information that BL31
Dan Handley7ce42df2014-05-15 14:11:36 +0100193 * could need
194 */
195struct bl31_params *bl2_plat_get_bl31_params(void);
196
197/*
198 * This function returns a pointer to the shared memory that the platform
199 * has kept to point to entry point information of BL31 to BL2
200 */
201struct entry_point_info *bl2_plat_get_bl31_ep_info(void);
202
203/*
204 * This function flushes to main memory all the params that are
Juan Castillo7d199412015-12-14 09:35:25 +0000205 * passed to BL31
Dan Handley7ce42df2014-05-15 14:11:36 +0100206 */
207void bl2_plat_flush_bl31_params(void);
208
Dan Handleyed6ff952014-05-14 17:44:19 +0100209/*
Sandrine Bailleuxf841ef02014-06-24 14:19:36 +0100210 * The next 2 functions allow the platform to change the entrypoint information
Juan Castillo7d199412015-12-14 09:35:25 +0000211 * for the mandatory 3rd level BL images, BL31 and BL33. This is done after
212 * BL2 has loaded those images into memory but before BL31 is executed.
Dan Handleyed6ff952014-05-14 17:44:19 +0100213 */
214void bl2_plat_set_bl31_ep_info(struct image_info *image,
215 struct entry_point_info *ep);
216
Sandrine Bailleuxf841ef02014-06-24 14:19:36 +0100217void bl2_plat_set_bl33_ep_info(struct image_info *image,
Dan Handleyed6ff952014-05-14 17:44:19 +0100218 struct entry_point_info *ep);
219
Juan Castillo7d199412015-12-14 09:35:25 +0000220/* Gets the memory layout for BL33 */
Sandrine Bailleuxf841ef02014-06-24 14:19:36 +0100221void bl2_plat_get_bl33_meminfo(struct meminfo *mem_info);
222
223/*******************************************************************************
Juan Castilloa72b6472015-12-10 15:49:17 +0000224 * Conditionally mandatory BL2 functions: must be implemented if SCP_BL2 image
Sandrine Bailleuxf841ef02014-06-24 14:19:36 +0100225 * is supported
226 ******************************************************************************/
Juan Castilloa72b6472015-12-10 15:49:17 +0000227/* Gets the memory layout for SCP_BL2 */
228void bl2_plat_get_scp_bl2_meminfo(struct meminfo *mem_info);
Sandrine Bailleuxf841ef02014-06-24 14:19:36 +0100229
230/*
Juan Castilloa72b6472015-12-10 15:49:17 +0000231 * This function is called after loading SCP_BL2 image and it is used to perform
Sandrine Bailleuxf841ef02014-06-24 14:19:36 +0100232 * any platform-specific actions required to handle the SCP firmware.
233 */
Juan Castilloa72b6472015-12-10 15:49:17 +0000234int bl2_plat_handle_scp_bl2(struct image_info *scp_bl2_image_info);
Sandrine Bailleuxf841ef02014-06-24 14:19:36 +0100235
236/*******************************************************************************
Juan Castillo7d199412015-12-14 09:35:25 +0000237 * Conditionally mandatory BL2 functions: must be implemented if BL32 image
Sandrine Bailleuxf841ef02014-06-24 14:19:36 +0100238 * is supported
239 ******************************************************************************/
240void bl2_plat_set_bl32_ep_info(struct image_info *image,
Dan Handleyed6ff952014-05-14 17:44:19 +0100241 struct entry_point_info *ep);
242
Juan Castillo7d199412015-12-14 09:35:25 +0000243/* Gets the memory layout for BL32 */
Dan Handleyed6ff952014-05-14 17:44:19 +0100244void bl2_plat_get_bl32_meminfo(struct meminfo *mem_info);
245
Yatharth Kochar3345a8d2016-09-12 16:08:41 +0100246#endif /* LOAD_IMAGE_V2 */
247
Dan Handley7ce42df2014-05-15 14:11:36 +0100248/*******************************************************************************
249 * Optional BL2 functions (may be overridden)
250 ******************************************************************************/
251
Roberto Vargase0e99462017-10-30 14:43:43 +0000252
253/*******************************************************************************
254 * Mandatory BL2 at EL3 functions: Must be implemented if BL2_AT_EL3 image is
255 * supported
256 ******************************************************************************/
257void bl2_el3_early_platform_setup(u_register_t arg0, u_register_t arg1,
258 u_register_t arg2, u_register_t arg3);
259void bl2_el3_plat_arch_setup(void);
260
261
262/*******************************************************************************
263 * Optional BL2 at EL3 functions (may be overridden)
264 ******************************************************************************/
265void bl2_el3_plat_prepare_exit(void);
266
Dan Handley7ce42df2014-05-15 14:11:36 +0100267/*******************************************************************************
Yatharth Kocharb1c2fe02015-10-14 15:27:24 +0100268 * Mandatory BL2U functions.
269 ******************************************************************************/
270void bl2u_early_platform_setup(struct meminfo *mem_layout,
271 void *plat_info);
272void bl2u_plat_arch_setup(void);
273void bl2u_platform_setup(void);
274
275/*******************************************************************************
276 * Conditionally mandatory BL2U functions for CSS platforms.
277 ******************************************************************************/
278/*
279 * This function is used to perform any platform-specific actions required to
280 * handle the BL2U_SCP firmware.
281 */
282int bl2u_plat_handle_scp_bl2u(void);
283
284/*******************************************************************************
Juan Castillo7d199412015-12-14 09:35:25 +0000285 * Mandatory BL31 functions
Dan Handley7ce42df2014-05-15 14:11:36 +0100286 ******************************************************************************/
Soby Mathew73308d02018-01-09 14:36:14 +0000287#if !ERROR_DEPRECATED
Yatharth Kochar3345a8d2016-09-12 16:08:41 +0100288#if LOAD_IMAGE_V2
289void bl31_early_platform_setup(void *from_bl2,
290 void *plat_params_from_bl2);
291#else
Dan Handley7ce42df2014-05-15 14:11:36 +0100292void bl31_early_platform_setup(struct bl31_params *from_bl2,
293 void *plat_params_from_bl2);
Yatharth Kochar3345a8d2016-09-12 16:08:41 +0100294#endif
Soby Mathew73308d02018-01-09 14:36:14 +0000295#endif /* ERROR_DEPRECATED */
296void bl31_early_platform_setup2(u_register_t arg0, u_register_t arg1,
297 u_register_t arg2, u_register_t arg3);
Dan Handley7ce42df2014-05-15 14:11:36 +0100298void bl31_plat_arch_setup(void);
299void bl31_platform_setup(void);
Soby Mathew1ff495b2015-12-09 11:28:43 +0000300void bl31_plat_runtime_setup(void);
Dan Handley701fea72014-05-27 16:17:21 +0100301struct entry_point_info *bl31_plat_get_next_image_ep_info(uint32_t type);
Dan Handley7ce42df2014-05-15 14:11:36 +0100302
303/*******************************************************************************
Juan Castillo7d199412015-12-14 09:35:25 +0000304 * Mandatory PSCI functions (BL31)
Dan Handley7ce42df2014-05-15 14:11:36 +0100305 ******************************************************************************/
Soby Mathew981487a2015-07-13 14:10:57 +0100306int plat_setup_psci_ops(uintptr_t sec_entrypoint,
Roberto Vargas777dd432018-02-12 12:36:17 +0000307 const struct plat_psci_ops **psci_ops);
Soby Mathew981487a2015-07-13 14:10:57 +0100308const unsigned char *plat_get_power_domain_tree_desc(void);
309
310/*******************************************************************************
Juan Castillo7d199412015-12-14 09:35:25 +0000311 * Optional PSCI functions (BL31).
Soby Mathew981487a2015-07-13 14:10:57 +0100312 ******************************************************************************/
dp-arm66abfbe2017-01-31 13:01:04 +0000313void plat_psci_stat_accounting_start(const psci_power_state_t *state_info);
314void plat_psci_stat_accounting_stop(const psci_power_state_t *state_info);
315u_register_t plat_psci_stat_get_residency(unsigned int lvl,
316 const psci_power_state_t *state_info,
Roberto Vargas777dd432018-02-12 12:36:17 +0000317 int last_cpu_idx);
Soby Mathew981487a2015-07-13 14:10:57 +0100318plat_local_state_t plat_get_target_pwr_state(unsigned int lvl,
319 const plat_local_state_t *states,
320 unsigned int ncpu);
Dan Handley7ce42df2014-05-15 14:11:36 +0100321
322/*******************************************************************************
Juan Castillo7d199412015-12-14 09:35:25 +0000323 * Optional BL31 functions (may be overridden)
Dan Handleyb226a4d2014-05-16 14:08:45 +0100324 ******************************************************************************/
Achin Guptae9982542014-06-26 08:59:07 +0100325void bl31_plat_enable_mmu(uint32_t flags);
Dan Handleyb226a4d2014-05-16 14:08:45 +0100326
327/*******************************************************************************
Juan Castillo7d199412015-12-14 09:35:25 +0000328 * Optional BL32 functions (may be overridden)
Dan Handleyb226a4d2014-05-16 14:08:45 +0100329 ******************************************************************************/
Achin Guptae9982542014-06-26 08:59:07 +0100330void bl32_plat_enable_mmu(uint32_t flags);
Dan Handleyb226a4d2014-05-16 14:08:45 +0100331
Juan Castillo5e29c752015-01-07 10:39:25 +0000332/*******************************************************************************
Juan Castillo31a68f02015-04-14 12:49:03 +0100333 * Trusted Board Boot functions
Juan Castillo5e29c752015-01-07 10:39:25 +0000334 ******************************************************************************/
Juan Castillo31a68f02015-04-14 12:49:03 +0100335int plat_get_rotpk_info(void *cookie, void **key_ptr, unsigned int *key_len,
336 unsigned int *flags);
Juan Castillobfb7fa62016-01-22 11:05:57 +0000337int plat_get_nv_ctr(void *cookie, unsigned int *nv_ctr);
338int plat_set_nv_ctr(void *cookie, unsigned int nv_ctr);
dp-armb3e85802016-12-12 14:48:13 +0000339int plat_set_nv_ctr2(void *cookie, const struct auth_img_desc_s *img_desc,
340 unsigned int nv_ctr);
Juan Castillo5e29c752015-01-07 10:39:25 +0000341
Antonio Nino Diazc41f2062017-10-24 10:07:35 +0100342/*******************************************************************************
343 * Secure Partitions functions
344 ******************************************************************************/
345const struct mmap_region *plat_get_secure_partition_mmap(void *cookie);
346const struct secure_partition_boot_info *plat_get_secure_partition_boot_info(
347 void *cookie);
348
Yatharth Kochar3345a8d2016-09-12 16:08:41 +0100349#if LOAD_IMAGE_V2
350/*******************************************************************************
351 * Mandatory BL image load functions(may be overridden).
352 ******************************************************************************/
353/*
354 * This function returns pointer to the list of images that the
355 * platform has populated to load.
356 */
357struct bl_load_info *plat_get_bl_image_load_info(void);
358
359/*
360 * This function returns a pointer to the shared memory that the
361 * platform has kept aside to pass trusted firmware related
362 * information that next BL image could need.
363 */
364struct bl_params *plat_get_next_bl_params(void);
365
366/*
367 * This function flushes to main memory all the params that are
368 * passed to next image.
369 */
370void plat_flush_next_bl_params(void);
371
372#endif /* LOAD_IMAGE_V2 */
373
Soby Mathew981487a2015-07-13 14:10:57 +0100374#if ENABLE_PLAT_COMPAT
375/*
376 * The below declarations are to enable compatibility for the platform ports
377 * using the old platform interface.
378 */
379
380/*******************************************************************************
381 * Optional common functions (may be overridden)
382 ******************************************************************************/
383unsigned int platform_get_core_pos(unsigned long mpidr);
384
385/*******************************************************************************
Juan Castillo7d199412015-12-14 09:35:25 +0000386 * Mandatory PSCI Compatibility functions (BL31)
Soby Mathew981487a2015-07-13 14:10:57 +0100387 ******************************************************************************/
388int platform_setup_pm(const plat_pm_ops_t **);
389
390unsigned int plat_get_aff_count(unsigned int, unsigned long);
391unsigned int plat_get_aff_state(unsigned int, unsigned long);
Roberto Vargas05712702018-02-12 12:36:17 +0000392
Douglas Raillard306593d2017-02-24 18:14:15 +0000393#else /* __ENABLE_PLAT_COMPAT__ */
Soby Mathew70716d62015-07-13 16:26:11 +0100394/*
395 * The below function enable Trusted Firmware components like SPDs which
396 * haven't migrated to the new platform API to compile on platforms which
397 * have the compatibility layer disabled.
398 */
Roberto Vargas05712702018-02-12 12:36:17 +0000399unsigned int platform_core_pos_helper(unsigned long mpidr);
Soren Brinkmanna581bd52016-01-14 10:02:33 -0800400unsigned int platform_get_core_pos(unsigned long mpidr) __deprecated;
Soby Mathew981487a2015-07-13 14:10:57 +0100401
Soby Mathew70716d62015-07-13 16:26:11 +0100402#endif /* __ENABLE_PLAT_COMPAT__ */
Douglas Raillard306593d2017-02-24 18:14:15 +0000403
Antonio Nino Diazfec756f2018-07-18 16:24:16 +0100404#endif /* PLATFORM_H */