mirror of
https://github.com/ARM-software/arm-trusted-firmware.git
synced 2025-04-24 22:05:40 +00:00

This patch defines deprecated platform APIs to enable Trusted Firmware components like Secure Payload and their dispatchers(SPD) to continue to build and run when platform compatibility is disabled. This decouples the migration of platform ports to the new platform API from SPD and enables them to be migrated independently. The deprecated platform APIs defined in this patch are : platform_get_core_pos(), platform_get_stack() and platform_set_stack(). The patch also deprecates MPIDR based context management helpers like cm_get_context_by_mpidr(), cm_set_context_by_mpidr() and cm_init_context(). A mechanism to deprecate APIs and identify callers of these APIs during build is introduced, which is controlled by the build flag WARN_DEPRECATED. If WARN_DEPRECATED is defined to 1, the users of the deprecated APIs will be flagged either as a link error for assembly files or compile time warning for C files during build. Change-Id: Ib72c7d5dc956e1a74d2294a939205b200f055613
196 lines
6.8 KiB
ArmAsm
196 lines
6.8 KiB
ArmAsm
/*
|
|
* Copyright (c) 2014, 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.
|
|
*/
|
|
|
|
#include <arch.h>
|
|
#include <asm_macros.S>
|
|
#include <assert_macros.S>
|
|
#include <platform_def.h>
|
|
|
|
.local platform_normal_stacks
|
|
#if ENABLE_PLAT_COMPAT
|
|
.globl plat_get_my_stack
|
|
.globl plat_set_my_stack
|
|
.weak platform_get_stack
|
|
.weak platform_set_stack
|
|
#else
|
|
.weak plat_get_my_stack
|
|
.weak plat_set_my_stack
|
|
.globl platform_get_stack
|
|
.globl platform_set_stack
|
|
#endif /* __ENABLE_PLAT_COMPAT__ */
|
|
|
|
#if ENABLE_PLAT_COMPAT
|
|
/* ---------------------------------------------------------------------
|
|
* When the compatility layer is enabled, the new platform APIs
|
|
* viz plat_get_my_stack() and plat_set_my_stack() need to be
|
|
* defined using the previous APIs platform_get_stack() and
|
|
* platform_set_stack(). Also we need to provide weak definitions
|
|
* of platform_get_stack() and platform_set_stack() for the platforms
|
|
* to reuse.
|
|
* --------------------------------------------------------------------
|
|
*/
|
|
|
|
/* -----------------------------------------------------
|
|
* unsigned long plat_get_my_stack ()
|
|
*
|
|
* For the current CPU, this function returns the stack
|
|
* pointer for a stack allocated in device memory.
|
|
* -----------------------------------------------------
|
|
*/
|
|
func plat_get_my_stack
|
|
mrs x0, mpidr_el1
|
|
b platform_get_stack
|
|
endfunc plat_get_my_stack
|
|
|
|
/* -----------------------------------------------------
|
|
* void plat_set_my_stack ()
|
|
*
|
|
* For the current CPU, this function sets the stack
|
|
* pointer to a stack allocated in normal memory.
|
|
* -----------------------------------------------------
|
|
*/
|
|
func plat_set_my_stack
|
|
mrs x0, mpidr_el1
|
|
b platform_set_stack
|
|
endfunc plat_set_my_stack
|
|
|
|
/* -----------------------------------------------------
|
|
* unsigned long platform_get_stack (unsigned long mpidr)
|
|
*
|
|
* For a given CPU, this function returns the stack
|
|
* pointer for a stack allocated in device memory.
|
|
* -----------------------------------------------------
|
|
*/
|
|
func platform_get_stack
|
|
mov x10, x30 // lr
|
|
get_mp_stack platform_normal_stacks, PLATFORM_STACK_SIZE
|
|
ret x10
|
|
endfunc platform_get_stack
|
|
|
|
/* -----------------------------------------------------
|
|
* void platform_set_stack (unsigned long mpidr)
|
|
*
|
|
* For a given CPU, this function sets the stack pointer
|
|
* to a stack allocated in normal memory.
|
|
* -----------------------------------------------------
|
|
*/
|
|
func platform_set_stack
|
|
mov x9, x30 // lr
|
|
bl platform_get_stack
|
|
mov sp, x0
|
|
ret x9
|
|
endfunc platform_set_stack
|
|
|
|
#else
|
|
/* ---------------------------------------------------------------------
|
|
* When the compatility layer is disabled, the new platform APIs
|
|
* viz plat_get_my_stack() and plat_set_my_stack() are
|
|
* supported by the platform and the previous APIs platform_get_stack()
|
|
* and platform_set_stack() are defined in terms of new APIs making use
|
|
* of the fact that they are only ever invoked for the current CPU.
|
|
* This is to enable components of Trusted Firmware like SPDs using the
|
|
* old platform APIs to continue to work.
|
|
* --------------------------------------------------------------------
|
|
*/
|
|
|
|
/* -------------------------------------------------------
|
|
* unsigned long platform_get_stack (unsigned long mpidr)
|
|
*
|
|
* For the current CPU, this function returns the stack
|
|
* pointer for a stack allocated in device memory. The
|
|
* 'mpidr' should correspond to that of the current CPU.
|
|
* This function is deprecated and plat_get_my_stack()
|
|
* should be used instead.
|
|
* -------------------------------------------------------
|
|
*/
|
|
func_deprecated platform_get_stack
|
|
#if ASM_ASSERTION
|
|
mrs x1, mpidr_el1
|
|
cmp x0, x1
|
|
ASM_ASSERT(eq)
|
|
#endif
|
|
b plat_get_my_stack
|
|
endfunc_deprecated platform_get_stack
|
|
|
|
/* -----------------------------------------------------
|
|
* void platform_set_stack (unsigned long mpidr)
|
|
*
|
|
* For the current CPU, this function sets the stack pointer
|
|
* to a stack allocated in normal memory. The
|
|
* 'mpidr' should correspond to that of the current CPU.
|
|
* This function is deprecated and plat_get_my_stack()
|
|
* should be used instead.
|
|
* -----------------------------------------------------
|
|
*/
|
|
func_deprecated platform_set_stack
|
|
#if ASM_ASSERTION
|
|
mrs x1, mpidr_el1
|
|
cmp x0, x1
|
|
ASM_ASSERT(eq)
|
|
#endif
|
|
b plat_set_my_stack
|
|
endfunc_deprecated platform_set_stack
|
|
|
|
/* -----------------------------------------------------
|
|
* unsigned long plat_get_my_stack ()
|
|
*
|
|
* For the current CPU, this function returns the stack
|
|
* pointer for a stack allocated in device memory.
|
|
* -----------------------------------------------------
|
|
*/
|
|
func plat_get_my_stack
|
|
mov x10, x30 // lr
|
|
get_my_mp_stack platform_normal_stacks, PLATFORM_STACK_SIZE
|
|
ret x10
|
|
endfunc plat_get_my_stack
|
|
|
|
/* -----------------------------------------------------
|
|
* void plat_set_my_stack ()
|
|
*
|
|
* For the current CPU, this function sets the stack
|
|
* pointer to a stack allocated in normal memory.
|
|
* -----------------------------------------------------
|
|
*/
|
|
func plat_set_my_stack
|
|
mov x9, x30 // lr
|
|
bl plat_get_my_stack
|
|
mov sp, x0
|
|
ret x9
|
|
endfunc plat_set_my_stack
|
|
|
|
#endif /*__ENABLE_PLAT_COMPAT__*/
|
|
|
|
/* -----------------------------------------------------
|
|
* Per-cpu stacks in normal memory. Each cpu gets a
|
|
* stack of PLATFORM_STACK_SIZE bytes.
|
|
* -----------------------------------------------------
|
|
*/
|
|
declare_stack platform_normal_stacks, tzfw_normal_stacks, \
|
|
PLATFORM_STACK_SIZE, PLATFORM_CORE_COUNT
|