include/plat/common/platform.h - filogic/atf - Gitiles

 /*
  * Copyright (c) 2013-2016, ARM Limited and Contributors. All rights reserved.
  *
  * Redistribution and use in source and binary forms, with or without
  * modification, are permitted provided that the following conditions are met:
  *
  * Redistributions of source code must retain the above copyright notice, this
  * list of conditions and the following disclaimer.
  *
  * Redistributions in binary form must reproduce the above copyright notice,
  * this list of conditions and the following disclaimer in the documentation
  * and/or other materials provided with the distribution.
  *
  * Neither the name of ARM nor the names of its contributors may be used
  * to endorse or promote products derived from this software without specific
  * prior written permission.
  *
  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
  * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  * POSSIBILITY OF SUCH DAMAGE.
  */

 #ifndef __PLATFORM_H__
 #define __PLATFORM_H__

 #include <psci.h>
 #include <stdint.h>
 #include <types.h>


 /*******************************************************************************
  * Forward declarations
  ******************************************************************************/
 struct meminfo;
 struct image_info;
 struct entry_point_info;
 struct bl31_params;
 struct image_desc;

 /*******************************************************************************
  * plat_get_rotpk_info() flags
  ******************************************************************************/
 #define ROTPK_IS_HASH			(1 << 0)

 /*******************************************************************************
  * Function declarations
  ******************************************************************************/
 /*******************************************************************************
  * Mandatory common functions
  ******************************************************************************/
 uint64_t plat_get_syscnt_freq(void);
 int plat_get_image_source(unsigned int image_id,
 			uintptr_t *dev_handle,
 			uintptr_t *image_spec);
 unsigned long plat_get_ns_image_entrypoint(void);
 unsigned int plat_my_core_pos(void);
 int plat_core_pos_by_mpidr(u_register_t mpidr);

 /*******************************************************************************
  * Mandatory interrupt management functions
  ******************************************************************************/
 uint32_t plat_ic_get_pending_interrupt_id(void);
 uint32_t plat_ic_get_pending_interrupt_type(void);
 uint32_t plat_ic_acknowledge_interrupt(void);
 uint32_t plat_ic_get_interrupt_type(uint32_t id);
 void plat_ic_end_of_interrupt(uint32_t id);
 uint32_t plat_interrupt_type_to_line(uint32_t type,
 				     uint32_t security_state);

 /*******************************************************************************
  * Optional common functions (may be overridden)
  ******************************************************************************/
 unsigned long plat_get_my_stack(void);
 void plat_report_exception(unsigned long);
 int plat_crash_console_init(void);
 int plat_crash_console_putc(int c);
 void plat_error_handler(int err) __dead2;
 void plat_panic_handler(void) __dead2;

 /*******************************************************************************
  * Mandatory BL1 functions
  ******************************************************************************/
 void bl1_early_platform_setup(void);
 void bl1_plat_arch_setup(void);
 void bl1_platform_setup(void);
 struct meminfo *bl1_plat_sec_mem_layout(void);

 /*
  * The following function is mandatory when the
  * firmware update feature is used.
  */
 int bl1_plat_mem_check(uintptr_t mem_base, unsigned int mem_size,
 		unsigned int flags);

 /*******************************************************************************
  * Optional BL1 functions (may be overridden)
  ******************************************************************************/
 void bl1_init_bl2_mem_layout(const struct meminfo *bl1_mem_layout,
 			     struct meminfo *bl2_mem_layout);

 /*
  * The following functions are used for image loading process in BL1.
  */
 void bl1_plat_set_ep_info(unsigned int image_id,
 		struct entry_point_info *ep_info);
 /*
  * The following functions are mandatory when firmware update
  * feature is used and optional otherwise.
  */
 unsigned int bl1_plat_get_next_image_id(void);
 struct image_desc *bl1_plat_get_image_desc(unsigned int image_id);

 /*
  * The following functions are used by firmware update
  * feature and may optionally be overridden.
  */
 __dead2 void bl1_plat_fwu_done(void *client_cookie, void *reserved);


 /*******************************************************************************
  * Mandatory BL2 functions
  ******************************************************************************/
 void bl2_early_platform_setup(struct meminfo *mem_layout);
 void bl2_plat_arch_setup(void);
 void bl2_platform_setup(void);
 struct meminfo *bl2_plat_sec_mem_layout(void);

 /*
  * This function returns a pointer to the shared memory that the platform has
  * kept aside to pass trusted firmware related information that BL31
  * could need
  */
 struct bl31_params *bl2_plat_get_bl31_params(void);

 /*
  * This function returns a pointer to the shared memory that the platform
  * has kept to point to entry point information of BL31 to BL2
  */
 struct entry_point_info *bl2_plat_get_bl31_ep_info(void);

 /*
  * This function flushes to main memory all the params that are
  * passed to BL31
  */
 void bl2_plat_flush_bl31_params(void);

 /*
  * The next 2 functions allow the platform to change the entrypoint information
  * for the mandatory 3rd level BL images, BL31 and BL33. This is done after
  * BL2 has loaded those images into memory but before BL31 is executed.
  */
 void bl2_plat_set_bl31_ep_info(struct image_info *image,
 			       struct entry_point_info *ep);

 void bl2_plat_set_bl33_ep_info(struct image_info *image,
 			       struct entry_point_info *ep);

 /* Gets the memory layout for BL33 */
 void bl2_plat_get_bl33_meminfo(struct meminfo *mem_info);

 /*******************************************************************************
  * Conditionally mandatory BL2 functions: must be implemented if SCP_BL2 image
  * is supported
  ******************************************************************************/
 /* Gets the memory layout for SCP_BL2 */
 void bl2_plat_get_scp_bl2_meminfo(struct meminfo *mem_info);

 /*
  * This function is called after loading SCP_BL2 image and it is used to perform
  * any platform-specific actions required to handle the SCP firmware.
  */
 int bl2_plat_handle_scp_bl2(struct image_info *scp_bl2_image_info);

 /*******************************************************************************
  * Conditionally mandatory BL2 functions: must be implemented if BL32 image
  * is supported
  ******************************************************************************/
 void bl2_plat_set_bl32_ep_info(struct image_info *image,
 			       struct entry_point_info *ep);

 /* Gets the memory layout for BL32 */
 void bl2_plat_get_bl32_meminfo(struct meminfo *mem_info);

 /*******************************************************************************
  * Optional BL2 functions (may be overridden)
  ******************************************************************************/

 /*******************************************************************************
  * Mandatory BL2U functions.
  ******************************************************************************/
 void bl2u_early_platform_setup(struct meminfo *mem_layout,
 		void *plat_info);
 void bl2u_plat_arch_setup(void);
 void bl2u_platform_setup(void);

 /*******************************************************************************
  * Conditionally mandatory BL2U functions for CSS platforms.
  ******************************************************************************/
 /*
  * This function is used to perform any platform-specific actions required to
  * handle the BL2U_SCP firmware.
  */
 int bl2u_plat_handle_scp_bl2u(void);

 /*******************************************************************************
  * Mandatory BL31 functions
  ******************************************************************************/
 void bl31_early_platform_setup(struct bl31_params *from_bl2,
 				void *plat_params_from_bl2);
 void bl31_plat_arch_setup(void);
 void bl31_platform_setup(void);
 void bl31_plat_runtime_setup(void);
 struct entry_point_info *bl31_plat_get_next_image_ep_info(uint32_t type);

 /*******************************************************************************
  * Mandatory PSCI functions (BL31)
  ******************************************************************************/
 int plat_setup_psci_ops(uintptr_t sec_entrypoint,
 			const struct plat_psci_ops **);
 const unsigned char *plat_get_power_domain_tree_desc(void);

 /*******************************************************************************
  * Optional PSCI functions (BL31).
  ******************************************************************************/
 plat_local_state_t plat_get_target_pwr_state(unsigned int lvl,
 			const plat_local_state_t *states,
 			unsigned int ncpu);

 /*******************************************************************************
  * Optional BL31 functions (may be overridden)
  ******************************************************************************/
 void bl31_plat_enable_mmu(uint32_t flags);

 /*******************************************************************************
  * Optional BL32 functions (may be overridden)
  ******************************************************************************/
 void bl32_plat_enable_mmu(uint32_t flags);

 /*******************************************************************************
  * Trusted Board Boot functions
  ******************************************************************************/
 int plat_get_rotpk_info(void *cookie, void **key_ptr, unsigned int *key_len,
 			unsigned int *flags);

 #if ENABLE_PLAT_COMPAT
 /*
  * The below declarations are to enable compatibility for the platform ports
  * using the old platform interface.
  */

 /*******************************************************************************
  * Optional common functions (may be overridden)
  ******************************************************************************/
 unsigned int platform_get_core_pos(unsigned long mpidr);

 /*******************************************************************************
  * Mandatory PSCI Compatibility functions (BL31)
  ******************************************************************************/
 int platform_setup_pm(const plat_pm_ops_t **);

 unsigned int plat_get_aff_count(unsigned int, unsigned long);
 unsigned int plat_get_aff_state(unsigned int, unsigned long);
 #else
 /*
  * The below function enable Trusted Firmware components like SPDs which
  * haven't migrated to the new platform API to compile on platforms which
  * have the compatibility layer disabled.
  */
 unsigned int platform_get_core_pos(unsigned long mpidr) __deprecated;

 #endif /* __ENABLE_PLAT_COMPAT__ */
 #endif /* __PLATFORM_H__ */
	/*
	* Copyright (c) 2013-2016, ARM Limited and Contributors. All rights reserved.
	*
	* Redistribution and use in source and binary forms, with or without
	* modification, are permitted provided that the following conditions are met:
	*
	* Redistributions of source code must retain the above copyright notice, this
	* list of conditions and the following disclaimer.
	*
	* Redistributions in binary form must reproduce the above copyright notice,
	* this list of conditions and the following disclaimer in the documentation
	* and/or other materials provided with the distribution.
	*
	* Neither the name of ARM nor the names of its contributors may be used
	* to endorse or promote products derived from this software without specific
	* prior written permission.
	*
	* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
	* AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
	* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
	* ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
	* LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
	* CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
	* SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
	* INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
	* CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
	* ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
	* POSSIBILITY OF SUCH DAMAGE.
	*/

	#ifndef __PLATFORM_H__
	#define __PLATFORM_H__

	#include <psci.h>
	#include <stdint.h>
	#include <types.h>


	/*******************************************************************************
	* Forward declarations
	******************************************************************************/
	struct meminfo;
	struct image_info;
	struct entry_point_info;
	struct bl31_params;
	struct image_desc;

	/*******************************************************************************
	* plat_get_rotpk_info() flags
	******************************************************************************/
	#define ROTPK_IS_HASH (1 << 0)

	/*******************************************************************************
	* Function declarations
	******************************************************************************/
	/*******************************************************************************
	* Mandatory common functions
	******************************************************************************/
	uint64_t plat_get_syscnt_freq(void);
	int plat_get_image_source(unsigned int image_id,
	uintptr_t *dev_handle,
	uintptr_t *image_spec);
	unsigned long plat_get_ns_image_entrypoint(void);
	unsigned int plat_my_core_pos(void);
	int plat_core_pos_by_mpidr(u_register_t mpidr);

	/*******************************************************************************
	* Mandatory interrupt management functions
	******************************************************************************/
	uint32_t plat_ic_get_pending_interrupt_id(void);
	uint32_t plat_ic_get_pending_interrupt_type(void);
	uint32_t plat_ic_acknowledge_interrupt(void);
	uint32_t plat_ic_get_interrupt_type(uint32_t id);
	void plat_ic_end_of_interrupt(uint32_t id);
	uint32_t plat_interrupt_type_to_line(uint32_t type,
	uint32_t security_state);

	/*******************************************************************************
	* Optional common functions (may be overridden)
	******************************************************************************/
	unsigned long plat_get_my_stack(void);
	void plat_report_exception(unsigned long);
	int plat_crash_console_init(void);
	int plat_crash_console_putc(int c);
	void plat_error_handler(int err) __dead2;
	void plat_panic_handler(void) __dead2;

	/*******************************************************************************
	* Mandatory BL1 functions
	******************************************************************************/
	void bl1_early_platform_setup(void);
	void bl1_plat_arch_setup(void);
	void bl1_platform_setup(void);
	struct meminfo *bl1_plat_sec_mem_layout(void);

	/*
	* The following function is mandatory when the
	* firmware update feature is used.
	*/
	int bl1_plat_mem_check(uintptr_t mem_base, unsigned int mem_size,
	unsigned int flags);

	/*******************************************************************************
	* Optional BL1 functions (may be overridden)
	******************************************************************************/
	void bl1_init_bl2_mem_layout(const struct meminfo *bl1_mem_layout,
	struct meminfo *bl2_mem_layout);

	/*
	* The following functions are used for image loading process in BL1.
	*/
	void bl1_plat_set_ep_info(unsigned int image_id,
	struct entry_point_info *ep_info);
	/*
	* The following functions are mandatory when firmware update
	* feature is used and optional otherwise.
	*/
	unsigned int bl1_plat_get_next_image_id(void);
	struct image_desc *bl1_plat_get_image_desc(unsigned int image_id);

	/*
	* The following functions are used by firmware update
	* feature and may optionally be overridden.
	*/
	__dead2 void bl1_plat_fwu_done(void client_cookie, void reserved);


	/*******************************************************************************
	* Mandatory BL2 functions
	******************************************************************************/
	void bl2_early_platform_setup(struct meminfo *mem_layout);
	void bl2_plat_arch_setup(void);
	void bl2_platform_setup(void);
	struct meminfo *bl2_plat_sec_mem_layout(void);

	/*
	* This function returns a pointer to the shared memory that the platform has
	* kept aside to pass trusted firmware related information that BL31
	* could need
	*/
	struct bl31_params *bl2_plat_get_bl31_params(void);

	/*
	* This function returns a pointer to the shared memory that the platform
	* has kept to point to entry point information of BL31 to BL2
	*/
	struct entry_point_info *bl2_plat_get_bl31_ep_info(void);

	/*
	* This function flushes to main memory all the params that are
	* passed to BL31
	*/
	void bl2_plat_flush_bl31_params(void);

	/*
	* The next 2 functions allow the platform to change the entrypoint information
	* for the mandatory 3rd level BL images, BL31 and BL33. This is done after
	* BL2 has loaded those images into memory but before BL31 is executed.
	*/
	void bl2_plat_set_bl31_ep_info(struct image_info *image,
	struct entry_point_info *ep);

	void bl2_plat_set_bl33_ep_info(struct image_info *image,
	struct entry_point_info *ep);

	/* Gets the memory layout for BL33 */
	void bl2_plat_get_bl33_meminfo(struct meminfo *mem_info);

	/*******************************************************************************
	* Conditionally mandatory BL2 functions: must be implemented if SCP_BL2 image
	* is supported
	******************************************************************************/
	/* Gets the memory layout for SCP_BL2 */
	void bl2_plat_get_scp_bl2_meminfo(struct meminfo *mem_info);

	/*
	* This function is called after loading SCP_BL2 image and it is used to perform
	* any platform-specific actions required to handle the SCP firmware.
	*/
	int bl2_plat_handle_scp_bl2(struct image_info *scp_bl2_image_info);

	/*******************************************************************************
	* Conditionally mandatory BL2 functions: must be implemented if BL32 image
	* is supported
	******************************************************************************/
	void bl2_plat_set_bl32_ep_info(struct image_info *image,
	struct entry_point_info *ep);

	/* Gets the memory layout for BL32 */
	void bl2_plat_get_bl32_meminfo(struct meminfo *mem_info);

	/*******************************************************************************
	* Optional BL2 functions (may be overridden)
	******************************************************************************/

	/*******************************************************************************
	* Mandatory BL2U functions.
	******************************************************************************/
	void bl2u_early_platform_setup(struct meminfo *mem_layout,
	void *plat_info);
	void bl2u_plat_arch_setup(void);
	void bl2u_platform_setup(void);

	/*******************************************************************************
	* Conditionally mandatory BL2U functions for CSS platforms.
	******************************************************************************/
	/*
	* This function is used to perform any platform-specific actions required to
	* handle the BL2U_SCP firmware.
	*/
	int bl2u_plat_handle_scp_bl2u(void);

	/*******************************************************************************
	* Mandatory BL31 functions
	******************************************************************************/
	void bl31_early_platform_setup(struct bl31_params *from_bl2,
	void *plat_params_from_bl2);
	void bl31_plat_arch_setup(void);
	void bl31_platform_setup(void);
	void bl31_plat_runtime_setup(void);
	struct entry_point_info *bl31_plat_get_next_image_ep_info(uint32_t type);

	/*******************************************************************************
	* Mandatory PSCI functions (BL31)
	******************************************************************************/
	int plat_setup_psci_ops(uintptr_t sec_entrypoint,
	const struct plat_psci_ops **);
	const unsigned char *plat_get_power_domain_tree_desc(void);

	/*******************************************************************************
	* Optional PSCI functions (BL31).
	******************************************************************************/
	plat_local_state_t plat_get_target_pwr_state(unsigned int lvl,
	const plat_local_state_t *states,
	unsigned int ncpu);

	/*******************************************************************************
	* Optional BL31 functions (may be overridden)
	******************************************************************************/
	void bl31_plat_enable_mmu(uint32_t flags);

	/*******************************************************************************
	* Optional BL32 functions (may be overridden)
	******************************************************************************/
	void bl32_plat_enable_mmu(uint32_t flags);

	/*******************************************************************************
	* Trusted Board Boot functions
	******************************************************************************/
	int plat_get_rotpk_info(void cookie, void key_ptr, unsigned int key_len,
	unsigned int *flags);

	#if ENABLE_PLAT_COMPAT
	/*
	* The below declarations are to enable compatibility for the platform ports
	* using the old platform interface.
	*/

	/*******************************************************************************
	* Optional common functions (may be overridden)
	******************************************************************************/
	unsigned int platform_get_core_pos(unsigned long mpidr);

	/*******************************************************************************
	* Mandatory PSCI Compatibility functions (BL31)
	******************************************************************************/
	int platform_setup_pm(const plat_pm_ops_t **);

	unsigned int plat_get_aff_count(unsigned int, unsigned long);
	unsigned int plat_get_aff_state(unsigned int, unsigned long);
	#else
	/*
	* The below function enable Trusted Firmware components like SPDs which
	* haven't migrated to the new platform API to compile on platforms which
	* have the compatibility layer disabled.
	*/
	unsigned int platform_get_core_pos(unsigned long mpidr) __deprecated;

	#endif /* __ENABLE_PLAT_COMPAT__ */
	#endif /* __PLATFORM_H__ */