xref: /rk3399_ARM-atf/include/common/desc_image_load.h (revision d38613df9aa7d81505ff1da6e2905b3216d51ce5)
172600226SYatharth Kochar /*
2*d9af1f7bSJulius Werner  * Copyright (c) 2016-2019, ARM Limited and Contributors. All rights reserved.
372600226SYatharth Kochar  *
482cb2c1aSdp-arm  * SPDX-License-Identifier: BSD-3-Clause
572600226SYatharth Kochar  */
6c3cf06f1SAntonio Nino Diaz #ifndef DESC_IMAGE_LOAD_H
7c3cf06f1SAntonio Nino Diaz #define DESC_IMAGE_LOAD_H
872600226SYatharth Kochar 
909d40e0eSAntonio Nino Diaz #include <common/bl_common.h>
1072600226SYatharth Kochar 
1172600226SYatharth Kochar /* Following structure is used to store BL ep/image info. */
1272600226SYatharth Kochar typedef struct bl_mem_params_node {
1372600226SYatharth Kochar 	unsigned int image_id;
1472600226SYatharth Kochar 	image_info_t image_info;
1572600226SYatharth Kochar 	entry_point_info_t ep_info;
1672600226SYatharth Kochar 	unsigned int next_handoff_image_id;
1772600226SYatharth Kochar 	bl_load_info_node_t load_node_mem;
1872600226SYatharth Kochar 	bl_params_node_t params_node_mem;
1972600226SYatharth Kochar } bl_mem_params_node_t;
2072600226SYatharth Kochar 
211af540efSRoberto Vargas extern bl_mem_params_node_t *bl_mem_params_desc_ptr;
221af540efSRoberto Vargas extern unsigned int bl_mem_params_desc_num;
231af540efSRoberto Vargas 
2472600226SYatharth Kochar /*
2572600226SYatharth Kochar  * Macro to register list of BL image descriptors,
2672600226SYatharth Kochar  * defined as an array of bl_mem_params_node_t.
2772600226SYatharth Kochar  */
2872600226SYatharth Kochar #define REGISTER_BL_IMAGE_DESCS(_img_desc)				\
2972600226SYatharth Kochar 	bl_mem_params_node_t *bl_mem_params_desc_ptr = &_img_desc[0];	\
3072600226SYatharth Kochar 	unsigned int bl_mem_params_desc_num = ARRAY_SIZE(_img_desc);
3172600226SYatharth Kochar 
3272600226SYatharth Kochar /* BL image loading utility functions */
3372600226SYatharth Kochar void flush_bl_params_desc(void);
345b8d50e4SSathees Balya void flush_bl_params_desc_args(bl_mem_params_node_t *mem_params_desc_ptr,
355b8d50e4SSathees Balya 	unsigned int mem_params_desc_num,
365b8d50e4SSathees Balya 	bl_params_t *next_bl_params_ptr);
3772600226SYatharth Kochar int get_bl_params_node_index(unsigned int image_id);
3872600226SYatharth Kochar bl_mem_params_node_t *get_bl_mem_params_node(unsigned int image_id);
3972600226SYatharth Kochar bl_load_info_t *get_bl_load_info_from_mem_params_desc(void);
4072600226SYatharth Kochar bl_params_t *get_next_bl_params_from_mem_params_desc(void);
41cab0b5b0SSoby Mathew void populate_next_bl_params_config(bl_params_t *bl2_to_next_bl_params);
4272600226SYatharth Kochar 
43*d9af1f7bSJulius Werner /* Helper to extract BL32/BL33 entry point info from arg0 passed to BL31. */
44*d9af1f7bSJulius Werner void bl31_params_parse_helper(u_register_t param,
45*d9af1f7bSJulius Werner 			      entry_point_info_t *bl32_ep_info_out,
46*d9af1f7bSJulius Werner 			      entry_point_info_t *bl33_ep_info_out);
47*d9af1f7bSJulius Werner 
48c3cf06f1SAntonio Nino Diaz #endif /* DESC_IMAGE_LOAD_H */
49