• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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