1 /* 2 * Copyright (c) 2016-2019, ARM Limited and Contributors. All rights reserved. 3 * 4 * SPDX-License-Identifier: BSD-3-Clause 5 */ 6 #ifndef DESC_IMAGE_LOAD_H 7 #define DESC_IMAGE_LOAD_H 8 9 #include <common/bl_common.h> 10 11 /* Following structure is used to store BL ep/image info. */ 12 typedef struct bl_mem_params_node { 13 unsigned int image_id; 14 image_info_t image_info; 15 entry_point_info_t ep_info; 16 unsigned int next_handoff_image_id; 17 bl_load_info_node_t load_node_mem; 18 bl_params_node_t params_node_mem; 19 } bl_mem_params_node_t; 20 21 extern bl_mem_params_node_t *bl_mem_params_desc_ptr; 22 extern unsigned int bl_mem_params_desc_num; 23 24 /* 25 * Macro to register list of BL image descriptors, 26 * defined as an array of bl_mem_params_node_t. 27 */ 28 #define REGISTER_BL_IMAGE_DESCS(_img_desc) \ 29 bl_mem_params_node_t *bl_mem_params_desc_ptr = &_img_desc[0]; \ 30 unsigned int bl_mem_params_desc_num = ARRAY_SIZE(_img_desc); 31 32 /* BL image loading utility functions */ 33 void flush_bl_params_desc(void); 34 void flush_bl_params_desc_args(bl_mem_params_node_t *mem_params_desc_ptr, 35 unsigned int mem_params_desc_num, 36 bl_params_t *next_bl_params_ptr); 37 int get_bl_params_node_index(unsigned int image_id); 38 bl_mem_params_node_t *get_bl_mem_params_node(unsigned int image_id); 39 bl_load_info_t *get_bl_load_info_from_mem_params_desc(void); 40 bl_params_t *get_next_bl_params_from_mem_params_desc(void); 41 void populate_next_bl_params_config(bl_params_t *bl2_to_next_bl_params); 42 43 /* Helper to extract BL32/BL33 entry point info from arg0 passed to BL31. */ 44 void bl31_params_parse_helper(u_register_t param, 45 entry_point_info_t *bl32_ep_info_out, 46 entry_point_info_t *bl33_ep_info_out); 47 48 #endif /* DESC_IMAGE_LOAD_H */ 49