Dan Handley | ed6ff95 | 2014-05-14 17:44:19 +0100 | [diff] [blame] | 1 | /* |
dp-arm | 66abfbe | 2017-01-31 13:01:04 +0000 | [diff] [blame] | 2 | * Copyright (c) 2013-2017, ARM Limited and Contributors. All rights reserved. |
Dan Handley | ed6ff95 | 2014-05-14 17:44:19 +0100 | [diff] [blame] | 3 | * |
dp-arm | fa3cf0b | 2017-05-03 09:38:09 +0100 | [diff] [blame] | 4 | * SPDX-License-Identifier: BSD-3-Clause |
Dan Handley | ed6ff95 | 2014-05-14 17:44:19 +0100 | [diff] [blame] | 5 | */ |
| 6 | |
| 7 | #ifndef __PLATFORM_H__ |
| 8 | #define __PLATFORM_H__ |
| 9 | |
Soby Mathew | 981487a | 2015-07-13 14:10:57 +0100 | [diff] [blame] | 10 | #include <psci.h> |
Dan Handley | ed6ff95 | 2014-05-14 17:44:19 +0100 | [diff] [blame] | 11 | #include <stdint.h> |
Soby Mathew | 981487a | 2015-07-13 14:10:57 +0100 | [diff] [blame] | 12 | #include <types.h> |
Dan Handley | ed6ff95 | 2014-05-14 17:44:19 +0100 | [diff] [blame] | 13 | |
| 14 | |
| 15 | /******************************************************************************* |
| 16 | * Forward declarations |
| 17 | ******************************************************************************/ |
dp-arm | b3e8580 | 2016-12-12 14:48:13 +0000 | [diff] [blame] | 18 | struct auth_img_desc_s; |
Dan Handley | ed6ff95 | 2014-05-14 17:44:19 +0100 | [diff] [blame] | 19 | struct meminfo; |
| 20 | struct image_info; |
| 21 | struct entry_point_info; |
Dan Handley | 7ce42df | 2014-05-15 14:11:36 +0100 | [diff] [blame] | 22 | struct bl31_params; |
Yatharth Kochar | a65be2f | 2015-10-09 18:06:13 +0100 | [diff] [blame] | 23 | struct image_desc; |
Yatharth Kochar | 3345a8d | 2016-09-12 16:08:41 +0100 | [diff] [blame] | 24 | struct bl_load_info; |
| 25 | struct bl_params; |
Dan Handley | ed6ff95 | 2014-05-14 17:44:19 +0100 | [diff] [blame] | 26 | |
| 27 | /******************************************************************************* |
Juan Castillo | 31a68f0 | 2015-04-14 12:49:03 +0100 | [diff] [blame] | 28 | * plat_get_rotpk_info() flags |
| 29 | ******************************************************************************/ |
| 30 | #define ROTPK_IS_HASH (1 << 0) |
Soby Mathew | 2f7ed05 | 2016-05-24 15:05:15 +0100 | [diff] [blame] | 31 | /* Flag used to skip verification of the certificate ROTPK while the platform |
| 32 | ROTPK is not deployed */ |
| 33 | #define ROTPK_NOT_DEPLOYED (1 << 1) |
Juan Castillo | 31a68f0 | 2015-04-14 12:49:03 +0100 | [diff] [blame] | 34 | |
| 35 | /******************************************************************************* |
Dan Handley | 7ce42df | 2014-05-15 14:11:36 +0100 | [diff] [blame] | 36 | * Function declarations |
Dan Handley | ed6ff95 | 2014-05-14 17:44:19 +0100 | [diff] [blame] | 37 | ******************************************************************************/ |
Dan Handley | 7ce42df | 2014-05-15 14:11:36 +0100 | [diff] [blame] | 38 | /******************************************************************************* |
| 39 | * Mandatory common functions |
| 40 | ******************************************************************************/ |
Antonio Nino Diaz | 391a76e | 2016-05-18 16:53:31 +0100 | [diff] [blame] | 41 | unsigned long long plat_get_syscnt_freq(void) __deprecated; |
| 42 | unsigned int plat_get_syscnt_freq2(void); |
| 43 | |
Juan Castillo | 3a66aca | 2015-04-13 17:36:19 +0100 | [diff] [blame] | 44 | int plat_get_image_source(unsigned int image_id, |
Dan Handley | 7ce42df | 2014-05-15 14:11:36 +0100 | [diff] [blame] | 45 | uintptr_t *dev_handle, |
| 46 | uintptr_t *image_spec); |
Soby Mathew | 21f9361 | 2016-03-23 10:11:10 +0000 | [diff] [blame] | 47 | uintptr_t plat_get_ns_image_entrypoint(void); |
Soby Mathew | 981487a | 2015-07-13 14:10:57 +0100 | [diff] [blame] | 48 | unsigned int plat_my_core_pos(void); |
| 49 | int plat_core_pos_by_mpidr(u_register_t mpidr); |
Dan Handley | 7ce42df | 2014-05-15 14:11:36 +0100 | [diff] [blame] | 50 | |
Douglas Raillard | 306593d | 2017-02-24 18:14:15 +0000 | [diff] [blame] | 51 | #if STACK_PROTECTOR_ENABLED |
| 52 | /* |
| 53 | * Return a new value to be used for the stack protection's canary. |
| 54 | * |
| 55 | * Ideally, this value is a random number that is impossible to predict by an |
| 56 | * attacker. |
| 57 | */ |
| 58 | u_register_t plat_get_stack_protector_canary(void); |
| 59 | #endif /* STACK_PROTECTOR_ENABLED */ |
| 60 | |
Dan Handley | 7ce42df | 2014-05-15 14:11:36 +0100 | [diff] [blame] | 61 | /******************************************************************************* |
| 62 | * Mandatory interrupt management functions |
| 63 | ******************************************************************************/ |
Dan Handley | 701fea7 | 2014-05-27 16:17:21 +0100 | [diff] [blame] | 64 | uint32_t plat_ic_get_pending_interrupt_id(void); |
| 65 | uint32_t plat_ic_get_pending_interrupt_type(void); |
| 66 | uint32_t plat_ic_acknowledge_interrupt(void); |
| 67 | uint32_t plat_ic_get_interrupt_type(uint32_t id); |
| 68 | void plat_ic_end_of_interrupt(uint32_t id); |
Dan Handley | ed6ff95 | 2014-05-14 17:44:19 +0100 | [diff] [blame] | 69 | uint32_t plat_interrupt_type_to_line(uint32_t type, |
| 70 | uint32_t security_state); |
| 71 | |
Dan Handley | 7ce42df | 2014-05-15 14:11:36 +0100 | [diff] [blame] | 72 | /******************************************************************************* |
Jeenu Viswambharan | b1e957e | 2017-09-22 08:32:09 +0100 | [diff] [blame] | 73 | * Optional interrupt management functions, depending on chosen EL3 components. |
| 74 | ******************************************************************************/ |
| 75 | unsigned int plat_ic_get_running_priority(void); |
Jeenu Viswambharan | 522a465 | 2017-09-22 08:32:09 +0100 | [diff] [blame] | 76 | int plat_ic_is_spi(unsigned int id); |
| 77 | int plat_ic_is_ppi(unsigned int id); |
| 78 | int plat_ic_is_sgi(unsigned int id); |
Jeenu Viswambharan | 24e7029 | 2017-09-22 08:32:09 +0100 | [diff] [blame] | 79 | unsigned int plat_ic_get_interrupt_active(unsigned int id); |
Jeenu Viswambharan | 0fcdfff | 2017-09-22 08:32:09 +0100 | [diff] [blame] | 80 | void plat_ic_disable_interrupt(unsigned int id); |
| 81 | void plat_ic_enable_interrupt(unsigned int id); |
Jeenu Viswambharan | c06f05c | 2017-09-22 08:32:09 +0100 | [diff] [blame] | 82 | int plat_ic_has_interrupt_type(unsigned int type); |
| 83 | void plat_ic_set_interrupt_type(unsigned int id, unsigned int type); |
Jeenu Viswambharan | 447b89d | 2017-09-22 08:32:09 +0100 | [diff] [blame] | 84 | void plat_ic_set_interrupt_priority(unsigned int id, unsigned int priority); |
Jeenu Viswambharan | ab14e9b | 2017-09-22 08:32:09 +0100 | [diff] [blame] | 85 | void plat_ic_raise_el3_sgi(int sgi_num, u_register_t target); |
Jeenu Viswambharan | dce70b3 | 2017-09-22 08:32:09 +0100 | [diff] [blame] | 86 | void plat_ic_set_spi_routing(unsigned int id, unsigned int routing_mode, |
| 87 | u_register_t mpidr); |
Jeenu Viswambharan | eb1c12c | 2017-09-22 08:32:09 +0100 | [diff] [blame] | 88 | void plat_ic_set_interrupt_pending(unsigned int id); |
| 89 | void plat_ic_clear_interrupt_pending(unsigned int id); |
Jeenu Viswambharan | 6250507 | 2017-09-22 08:32:09 +0100 | [diff] [blame] | 90 | unsigned int plat_ic_set_priority_mask(unsigned int mask); |
Jeenu Viswambharan | b1e957e | 2017-09-22 08:32:09 +0100 | [diff] [blame] | 91 | |
| 92 | /******************************************************************************* |
Dan Handley | 7ce42df | 2014-05-15 14:11:36 +0100 | [diff] [blame] | 93 | * Optional common functions (may be overridden) |
| 94 | ******************************************************************************/ |
Soby Mathew | a0fedc4 | 2016-06-16 14:52:04 +0100 | [diff] [blame] | 95 | uintptr_t plat_get_my_stack(void); |
Yatharth Kochar | f528faf | 2016-06-28 16:58:26 +0100 | [diff] [blame] | 96 | void plat_report_exception(unsigned int exception_type); |
Sandrine Bailleux | 046cd3f | 2014-08-06 11:27:23 +0100 | [diff] [blame] | 97 | int plat_crash_console_init(void); |
Soby Mathew | 066f713 | 2014-07-14 16:57:23 +0100 | [diff] [blame] | 98 | int plat_crash_console_putc(int c); |
Antonio Nino Diaz | d3ec543 | 2017-02-17 17:11:27 +0000 | [diff] [blame] | 99 | int plat_crash_console_flush(void); |
Juan Castillo | 26ae583 | 2015-09-25 15:41:14 +0100 | [diff] [blame] | 100 | void plat_error_handler(int err) __dead2; |
Antonio Nino Diaz | 1f21bcf | 2016-02-01 13:57:25 +0000 | [diff] [blame] | 101 | void plat_panic_handler(void) __dead2; |
Soby Mathew | aaf15f5 | 2017-09-04 11:49:29 +0100 | [diff] [blame] | 102 | const char *plat_log_get_prefix(unsigned int log_level); |
Dan Handley | 7ce42df | 2014-05-15 14:11:36 +0100 | [diff] [blame] | 103 | |
| 104 | /******************************************************************************* |
| 105 | * Mandatory BL1 functions |
| 106 | ******************************************************************************/ |
Dan Handley | 4fd2f5c | 2014-08-04 11:41:20 +0100 | [diff] [blame] | 107 | void bl1_early_platform_setup(void); |
Dan Handley | 7ce42df | 2014-05-15 14:11:36 +0100 | [diff] [blame] | 108 | void bl1_plat_arch_setup(void); |
| 109 | void bl1_platform_setup(void); |
| 110 | struct meminfo *bl1_plat_sec_mem_layout(void); |
Dan Handley | ed6ff95 | 2014-05-14 17:44:19 +0100 | [diff] [blame] | 111 | |
Yatharth Kochar | 71c9a5e | 2015-10-10 19:06:53 +0100 | [diff] [blame] | 112 | /* |
| 113 | * The following function is mandatory when the |
| 114 | * firmware update feature is used. |
| 115 | */ |
| 116 | int bl1_plat_mem_check(uintptr_t mem_base, unsigned int mem_size, |
| 117 | unsigned int flags); |
| 118 | |
Dan Handley | 7ce42df | 2014-05-15 14:11:36 +0100 | [diff] [blame] | 119 | /******************************************************************************* |
| 120 | * Optional BL1 functions (may be overridden) |
| 121 | ******************************************************************************/ |
Sandrine Bailleux | 467d057 | 2014-06-24 14:02:34 +0100 | [diff] [blame] | 122 | void bl1_init_bl2_mem_layout(const struct meminfo *bl1_mem_layout, |
| 123 | struct meminfo *bl2_mem_layout); |
Yatharth Kochar | 71c9a5e | 2015-10-10 19:06:53 +0100 | [diff] [blame] | 124 | |
Yatharth Kochar | a65be2f | 2015-10-09 18:06:13 +0100 | [diff] [blame] | 125 | /* |
| 126 | * The following functions are used for image loading process in BL1. |
| 127 | */ |
| 128 | void bl1_plat_set_ep_info(unsigned int image_id, |
| 129 | struct entry_point_info *ep_info); |
Yatharth Kochar | 71c9a5e | 2015-10-10 19:06:53 +0100 | [diff] [blame] | 130 | /* |
| 131 | * The following functions are mandatory when firmware update |
| 132 | * feature is used and optional otherwise. |
| 133 | */ |
Yatharth Kochar | a65be2f | 2015-10-09 18:06:13 +0100 | [diff] [blame] | 134 | unsigned int bl1_plat_get_next_image_id(void); |
| 135 | struct image_desc *bl1_plat_get_image_desc(unsigned int image_id); |
Dan Handley | 7ce42df | 2014-05-15 14:11:36 +0100 | [diff] [blame] | 136 | |
Yatharth Kochar | 71c9a5e | 2015-10-10 19:06:53 +0100 | [diff] [blame] | 137 | /* |
| 138 | * The following functions are used by firmware update |
| 139 | * feature and may optionally be overridden. |
| 140 | */ |
Dan Handley | 89f8f33 | 2015-12-15 14:28:24 +0000 | [diff] [blame] | 141 | __dead2 void bl1_plat_fwu_done(void *client_cookie, void *reserved); |
Yatharth Kochar | 71c9a5e | 2015-10-10 19:06:53 +0100 | [diff] [blame] | 142 | |
| 143 | |
Dan Handley | 7ce42df | 2014-05-15 14:11:36 +0100 | [diff] [blame] | 144 | /******************************************************************************* |
| 145 | * Mandatory BL2 functions |
| 146 | ******************************************************************************/ |
Dan Handley | 4fd2f5c | 2014-08-04 11:41:20 +0100 | [diff] [blame] | 147 | void bl2_early_platform_setup(struct meminfo *mem_layout); |
Dan Handley | 7ce42df | 2014-05-15 14:11:36 +0100 | [diff] [blame] | 148 | void bl2_plat_arch_setup(void); |
| 149 | void bl2_platform_setup(void); |
| 150 | struct meminfo *bl2_plat_sec_mem_layout(void); |
| 151 | |
Yatharth Kochar | 3345a8d | 2016-09-12 16:08:41 +0100 | [diff] [blame] | 152 | #if LOAD_IMAGE_V2 |
| 153 | /* |
| 154 | * This function can be used by the platforms to update/use image |
| 155 | * information for given `image_id`. |
| 156 | */ |
| 157 | int bl2_plat_handle_post_image_load(unsigned int image_id); |
| 158 | |
| 159 | #else /* LOAD_IMAGE_V2 */ |
| 160 | |
Dan Handley | 7ce42df | 2014-05-15 14:11:36 +0100 | [diff] [blame] | 161 | /* |
| 162 | * This function returns a pointer to the shared memory that the platform has |
Juan Castillo | 7d19941 | 2015-12-14 09:35:25 +0000 | [diff] [blame] | 163 | * kept aside to pass trusted firmware related information that BL31 |
Dan Handley | 7ce42df | 2014-05-15 14:11:36 +0100 | [diff] [blame] | 164 | * could need |
| 165 | */ |
| 166 | struct bl31_params *bl2_plat_get_bl31_params(void); |
| 167 | |
| 168 | /* |
| 169 | * This function returns a pointer to the shared memory that the platform |
| 170 | * has kept to point to entry point information of BL31 to BL2 |
| 171 | */ |
| 172 | struct entry_point_info *bl2_plat_get_bl31_ep_info(void); |
| 173 | |
| 174 | /* |
| 175 | * This function flushes to main memory all the params that are |
Juan Castillo | 7d19941 | 2015-12-14 09:35:25 +0000 | [diff] [blame] | 176 | * passed to BL31 |
Dan Handley | 7ce42df | 2014-05-15 14:11:36 +0100 | [diff] [blame] | 177 | */ |
| 178 | void bl2_plat_flush_bl31_params(void); |
| 179 | |
Dan Handley | ed6ff95 | 2014-05-14 17:44:19 +0100 | [diff] [blame] | 180 | /* |
Sandrine Bailleux | f841ef0 | 2014-06-24 14:19:36 +0100 | [diff] [blame] | 181 | * The next 2 functions allow the platform to change the entrypoint information |
Juan Castillo | 7d19941 | 2015-12-14 09:35:25 +0000 | [diff] [blame] | 182 | * for the mandatory 3rd level BL images, BL31 and BL33. This is done after |
| 183 | * BL2 has loaded those images into memory but before BL31 is executed. |
Dan Handley | ed6ff95 | 2014-05-14 17:44:19 +0100 | [diff] [blame] | 184 | */ |
| 185 | void bl2_plat_set_bl31_ep_info(struct image_info *image, |
| 186 | struct entry_point_info *ep); |
| 187 | |
Sandrine Bailleux | f841ef0 | 2014-06-24 14:19:36 +0100 | [diff] [blame] | 188 | void bl2_plat_set_bl33_ep_info(struct image_info *image, |
Dan Handley | ed6ff95 | 2014-05-14 17:44:19 +0100 | [diff] [blame] | 189 | struct entry_point_info *ep); |
| 190 | |
Juan Castillo | 7d19941 | 2015-12-14 09:35:25 +0000 | [diff] [blame] | 191 | /* Gets the memory layout for BL33 */ |
Sandrine Bailleux | f841ef0 | 2014-06-24 14:19:36 +0100 | [diff] [blame] | 192 | void bl2_plat_get_bl33_meminfo(struct meminfo *mem_info); |
| 193 | |
| 194 | /******************************************************************************* |
Juan Castillo | a72b647 | 2015-12-10 15:49:17 +0000 | [diff] [blame] | 195 | * Conditionally mandatory BL2 functions: must be implemented if SCP_BL2 image |
Sandrine Bailleux | f841ef0 | 2014-06-24 14:19:36 +0100 | [diff] [blame] | 196 | * is supported |
| 197 | ******************************************************************************/ |
Juan Castillo | a72b647 | 2015-12-10 15:49:17 +0000 | [diff] [blame] | 198 | /* Gets the memory layout for SCP_BL2 */ |
| 199 | void bl2_plat_get_scp_bl2_meminfo(struct meminfo *mem_info); |
Sandrine Bailleux | f841ef0 | 2014-06-24 14:19:36 +0100 | [diff] [blame] | 200 | |
| 201 | /* |
Juan Castillo | a72b647 | 2015-12-10 15:49:17 +0000 | [diff] [blame] | 202 | * This function is called after loading SCP_BL2 image and it is used to perform |
Sandrine Bailleux | f841ef0 | 2014-06-24 14:19:36 +0100 | [diff] [blame] | 203 | * any platform-specific actions required to handle the SCP firmware. |
| 204 | */ |
Juan Castillo | a72b647 | 2015-12-10 15:49:17 +0000 | [diff] [blame] | 205 | int bl2_plat_handle_scp_bl2(struct image_info *scp_bl2_image_info); |
Sandrine Bailleux | f841ef0 | 2014-06-24 14:19:36 +0100 | [diff] [blame] | 206 | |
| 207 | /******************************************************************************* |
Juan Castillo | 7d19941 | 2015-12-14 09:35:25 +0000 | [diff] [blame] | 208 | * Conditionally mandatory BL2 functions: must be implemented if BL32 image |
Sandrine Bailleux | f841ef0 | 2014-06-24 14:19:36 +0100 | [diff] [blame] | 209 | * is supported |
| 210 | ******************************************************************************/ |
| 211 | void bl2_plat_set_bl32_ep_info(struct image_info *image, |
Dan Handley | ed6ff95 | 2014-05-14 17:44:19 +0100 | [diff] [blame] | 212 | struct entry_point_info *ep); |
| 213 | |
Juan Castillo | 7d19941 | 2015-12-14 09:35:25 +0000 | [diff] [blame] | 214 | /* Gets the memory layout for BL32 */ |
Dan Handley | ed6ff95 | 2014-05-14 17:44:19 +0100 | [diff] [blame] | 215 | void bl2_plat_get_bl32_meminfo(struct meminfo *mem_info); |
| 216 | |
Yatharth Kochar | 3345a8d | 2016-09-12 16:08:41 +0100 | [diff] [blame] | 217 | #endif /* LOAD_IMAGE_V2 */ |
| 218 | |
Dan Handley | 7ce42df | 2014-05-15 14:11:36 +0100 | [diff] [blame] | 219 | /******************************************************************************* |
| 220 | * Optional BL2 functions (may be overridden) |
| 221 | ******************************************************************************/ |
| 222 | |
| 223 | /******************************************************************************* |
Yatharth Kochar | b1c2fe0 | 2015-10-14 15:27:24 +0100 | [diff] [blame] | 224 | * Mandatory BL2U functions. |
| 225 | ******************************************************************************/ |
| 226 | void bl2u_early_platform_setup(struct meminfo *mem_layout, |
| 227 | void *plat_info); |
| 228 | void bl2u_plat_arch_setup(void); |
| 229 | void bl2u_platform_setup(void); |
| 230 | |
| 231 | /******************************************************************************* |
| 232 | * Conditionally mandatory BL2U functions for CSS platforms. |
| 233 | ******************************************************************************/ |
| 234 | /* |
| 235 | * This function is used to perform any platform-specific actions required to |
| 236 | * handle the BL2U_SCP firmware. |
| 237 | */ |
| 238 | int bl2u_plat_handle_scp_bl2u(void); |
| 239 | |
| 240 | /******************************************************************************* |
Juan Castillo | 7d19941 | 2015-12-14 09:35:25 +0000 | [diff] [blame] | 241 | * Mandatory BL31 functions |
Dan Handley | 7ce42df | 2014-05-15 14:11:36 +0100 | [diff] [blame] | 242 | ******************************************************************************/ |
Yatharth Kochar | 3345a8d | 2016-09-12 16:08:41 +0100 | [diff] [blame] | 243 | #if LOAD_IMAGE_V2 |
| 244 | void bl31_early_platform_setup(void *from_bl2, |
| 245 | void *plat_params_from_bl2); |
| 246 | #else |
Dan Handley | 7ce42df | 2014-05-15 14:11:36 +0100 | [diff] [blame] | 247 | void bl31_early_platform_setup(struct bl31_params *from_bl2, |
| 248 | void *plat_params_from_bl2); |
Yatharth Kochar | 3345a8d | 2016-09-12 16:08:41 +0100 | [diff] [blame] | 249 | #endif |
Dan Handley | 7ce42df | 2014-05-15 14:11:36 +0100 | [diff] [blame] | 250 | void bl31_plat_arch_setup(void); |
| 251 | void bl31_platform_setup(void); |
Soby Mathew | 1ff495b | 2015-12-09 11:28:43 +0000 | [diff] [blame] | 252 | void bl31_plat_runtime_setup(void); |
Dan Handley | 701fea7 | 2014-05-27 16:17:21 +0100 | [diff] [blame] | 253 | struct entry_point_info *bl31_plat_get_next_image_ep_info(uint32_t type); |
Dan Handley | 7ce42df | 2014-05-15 14:11:36 +0100 | [diff] [blame] | 254 | |
| 255 | /******************************************************************************* |
Juan Castillo | 7d19941 | 2015-12-14 09:35:25 +0000 | [diff] [blame] | 256 | * Mandatory PSCI functions (BL31) |
Dan Handley | 7ce42df | 2014-05-15 14:11:36 +0100 | [diff] [blame] | 257 | ******************************************************************************/ |
Soby Mathew | 981487a | 2015-07-13 14:10:57 +0100 | [diff] [blame] | 258 | int plat_setup_psci_ops(uintptr_t sec_entrypoint, |
| 259 | const struct plat_psci_ops **); |
| 260 | const unsigned char *plat_get_power_domain_tree_desc(void); |
| 261 | |
| 262 | /******************************************************************************* |
Juan Castillo | 7d19941 | 2015-12-14 09:35:25 +0000 | [diff] [blame] | 263 | * Optional PSCI functions (BL31). |
Soby Mathew | 981487a | 2015-07-13 14:10:57 +0100 | [diff] [blame] | 264 | ******************************************************************************/ |
dp-arm | 66abfbe | 2017-01-31 13:01:04 +0000 | [diff] [blame] | 265 | void plat_psci_stat_accounting_start(const psci_power_state_t *state_info); |
| 266 | void plat_psci_stat_accounting_stop(const psci_power_state_t *state_info); |
| 267 | u_register_t plat_psci_stat_get_residency(unsigned int lvl, |
| 268 | const psci_power_state_t *state_info, |
| 269 | int last_cpu_index); |
Soby Mathew | 981487a | 2015-07-13 14:10:57 +0100 | [diff] [blame] | 270 | plat_local_state_t plat_get_target_pwr_state(unsigned int lvl, |
| 271 | const plat_local_state_t *states, |
| 272 | unsigned int ncpu); |
Dan Handley | 7ce42df | 2014-05-15 14:11:36 +0100 | [diff] [blame] | 273 | |
| 274 | /******************************************************************************* |
Juan Castillo | 7d19941 | 2015-12-14 09:35:25 +0000 | [diff] [blame] | 275 | * Optional BL31 functions (may be overridden) |
Dan Handley | b226a4d | 2014-05-16 14:08:45 +0100 | [diff] [blame] | 276 | ******************************************************************************/ |
Achin Gupta | e998254 | 2014-06-26 08:59:07 +0100 | [diff] [blame] | 277 | void bl31_plat_enable_mmu(uint32_t flags); |
Dan Handley | b226a4d | 2014-05-16 14:08:45 +0100 | [diff] [blame] | 278 | |
| 279 | /******************************************************************************* |
Juan Castillo | 7d19941 | 2015-12-14 09:35:25 +0000 | [diff] [blame] | 280 | * Optional BL32 functions (may be overridden) |
Dan Handley | b226a4d | 2014-05-16 14:08:45 +0100 | [diff] [blame] | 281 | ******************************************************************************/ |
Achin Gupta | e998254 | 2014-06-26 08:59:07 +0100 | [diff] [blame] | 282 | void bl32_plat_enable_mmu(uint32_t flags); |
Dan Handley | b226a4d | 2014-05-16 14:08:45 +0100 | [diff] [blame] | 283 | |
Juan Castillo | 5e29c75 | 2015-01-07 10:39:25 +0000 | [diff] [blame] | 284 | /******************************************************************************* |
Juan Castillo | 31a68f0 | 2015-04-14 12:49:03 +0100 | [diff] [blame] | 285 | * Trusted Board Boot functions |
Juan Castillo | 5e29c75 | 2015-01-07 10:39:25 +0000 | [diff] [blame] | 286 | ******************************************************************************/ |
Juan Castillo | 31a68f0 | 2015-04-14 12:49:03 +0100 | [diff] [blame] | 287 | int plat_get_rotpk_info(void *cookie, void **key_ptr, unsigned int *key_len, |
| 288 | unsigned int *flags); |
Juan Castillo | bfb7fa6 | 2016-01-22 11:05:57 +0000 | [diff] [blame] | 289 | int plat_get_nv_ctr(void *cookie, unsigned int *nv_ctr); |
| 290 | int plat_set_nv_ctr(void *cookie, unsigned int nv_ctr); |
dp-arm | b3e8580 | 2016-12-12 14:48:13 +0000 | [diff] [blame] | 291 | int plat_set_nv_ctr2(void *cookie, const struct auth_img_desc_s *img_desc, |
| 292 | unsigned int nv_ctr); |
Juan Castillo | 5e29c75 | 2015-01-07 10:39:25 +0000 | [diff] [blame] | 293 | |
Yatharth Kochar | 3345a8d | 2016-09-12 16:08:41 +0100 | [diff] [blame] | 294 | #if LOAD_IMAGE_V2 |
| 295 | /******************************************************************************* |
| 296 | * Mandatory BL image load functions(may be overridden). |
| 297 | ******************************************************************************/ |
| 298 | /* |
| 299 | * This function returns pointer to the list of images that the |
| 300 | * platform has populated to load. |
| 301 | */ |
| 302 | struct bl_load_info *plat_get_bl_image_load_info(void); |
| 303 | |
| 304 | /* |
| 305 | * This function returns a pointer to the shared memory that the |
| 306 | * platform has kept aside to pass trusted firmware related |
| 307 | * information that next BL image could need. |
| 308 | */ |
| 309 | struct bl_params *plat_get_next_bl_params(void); |
| 310 | |
| 311 | /* |
| 312 | * This function flushes to main memory all the params that are |
| 313 | * passed to next image. |
| 314 | */ |
| 315 | void plat_flush_next_bl_params(void); |
| 316 | |
| 317 | #endif /* LOAD_IMAGE_V2 */ |
| 318 | |
Soby Mathew | 981487a | 2015-07-13 14:10:57 +0100 | [diff] [blame] | 319 | #if ENABLE_PLAT_COMPAT |
| 320 | /* |
| 321 | * The below declarations are to enable compatibility for the platform ports |
| 322 | * using the old platform interface. |
| 323 | */ |
| 324 | |
| 325 | /******************************************************************************* |
| 326 | * Optional common functions (may be overridden) |
| 327 | ******************************************************************************/ |
| 328 | unsigned int platform_get_core_pos(unsigned long mpidr); |
| 329 | |
| 330 | /******************************************************************************* |
Juan Castillo | 7d19941 | 2015-12-14 09:35:25 +0000 | [diff] [blame] | 331 | * Mandatory PSCI Compatibility functions (BL31) |
Soby Mathew | 981487a | 2015-07-13 14:10:57 +0100 | [diff] [blame] | 332 | ******************************************************************************/ |
| 333 | int platform_setup_pm(const plat_pm_ops_t **); |
| 334 | |
| 335 | unsigned int plat_get_aff_count(unsigned int, unsigned long); |
| 336 | unsigned int plat_get_aff_state(unsigned int, unsigned long); |
Douglas Raillard | 306593d | 2017-02-24 18:14:15 +0000 | [diff] [blame] | 337 | #else /* __ENABLE_PLAT_COMPAT__ */ |
Soby Mathew | 70716d6 | 2015-07-13 16:26:11 +0100 | [diff] [blame] | 338 | /* |
| 339 | * The below function enable Trusted Firmware components like SPDs which |
| 340 | * haven't migrated to the new platform API to compile on platforms which |
| 341 | * have the compatibility layer disabled. |
| 342 | */ |
Soren Brinkmann | a581bd5 | 2016-01-14 10:02:33 -0800 | [diff] [blame] | 343 | unsigned int platform_get_core_pos(unsigned long mpidr) __deprecated; |
Soby Mathew | 981487a | 2015-07-13 14:10:57 +0100 | [diff] [blame] | 344 | |
Soby Mathew | 70716d6 | 2015-07-13 16:26:11 +0100 | [diff] [blame] | 345 | #endif /* __ENABLE_PLAT_COMPAT__ */ |
Douglas Raillard | 306593d | 2017-02-24 18:14:15 +0000 | [diff] [blame] | 346 | |
Dan Handley | ed6ff95 | 2014-05-14 17:44:19 +0100 | [diff] [blame] | 347 | #endif /* __PLATFORM_H__ */ |
Douglas Raillard | 306593d | 2017-02-24 18:14:15 +0000 | [diff] [blame] | 348 | |