mirror of
https://github.com/ARM-software/arm-trusted-firmware.git
synced 2025-04-15 17:14:21 +00:00
6873088c2c
Added SiP calls to FVP platform to protect/unprotect a memory range. These leverage rme features to change the PAS of a given memory range from non-secure to secure. The mentioned call is leveraged by the SPMC in the memory sharing flow, when memory is shared from the normal world onto the secure world. More details in the SPM related patches. Signed-off-by: Olivier Deprez <olivier.deprez@arm.com> Signed-off-by: J-Alves <joao.alves@arm.com> Change-Id: Iaf15d8603a549d247ffb1fc14c16bfb94d0e178a
232 lines
7.8 KiB
C
232 lines
7.8 KiB
C
/*
|
|
* Copyright (c) 2016-2023, Arm Limited and Contributors. All rights reserved.
|
|
*
|
|
* SPDX-License-Identifier: BSD-3-Clause
|
|
*/
|
|
|
|
#ifndef SMCCC_H
|
|
#define SMCCC_H
|
|
|
|
#include <lib/utils_def.h>
|
|
|
|
#define SMCCC_VERSION_MAJOR_SHIFT U(16)
|
|
#define SMCCC_VERSION_MAJOR_MASK U(0x7FFF)
|
|
#define SMCCC_VERSION_MINOR_SHIFT U(0)
|
|
#define SMCCC_VERSION_MINOR_MASK U(0xFFFF)
|
|
#define MAKE_SMCCC_VERSION(_major, _minor) \
|
|
((((uint32_t)(_major) & SMCCC_VERSION_MAJOR_MASK) << \
|
|
SMCCC_VERSION_MAJOR_SHIFT) \
|
|
| (((uint32_t)(_minor) & SMCCC_VERSION_MINOR_MASK) << \
|
|
SMCCC_VERSION_MINOR_SHIFT))
|
|
|
|
#define SMCCC_MAJOR_VERSION U(1)
|
|
#define SMCCC_MINOR_VERSION U(4)
|
|
|
|
/*******************************************************************************
|
|
* Bit definitions inside the function id as per the SMC calling convention
|
|
******************************************************************************/
|
|
#define FUNCID_TYPE_SHIFT U(31)
|
|
#define FUNCID_TYPE_MASK U(0x1)
|
|
#define FUNCID_TYPE_WIDTH U(1)
|
|
|
|
#define FUNCID_CC_SHIFT U(30)
|
|
#define FUNCID_CC_MASK U(0x1)
|
|
#define FUNCID_CC_WIDTH U(1)
|
|
|
|
#define FUNCID_OEN_SHIFT U(24)
|
|
#define FUNCID_OEN_MASK U(0x3f)
|
|
#define FUNCID_OEN_WIDTH U(6)
|
|
|
|
#define FUNCID_FC_RESERVED_SHIFT U(17)
|
|
#define FUNCID_FC_RESERVED_MASK U(0x7f)
|
|
#define FUNCID_FC_RESERVED_WIDTH U(7)
|
|
|
|
#define FUNCID_SVE_HINT_SHIFT U(16)
|
|
#define FUNCID_SVE_HINT_MASK U(1)
|
|
#define FUNCID_SVE_HINT_WIDTH U(1)
|
|
|
|
#define FUNCID_NUM_SHIFT U(0)
|
|
#define FUNCID_NUM_MASK U(0xffff)
|
|
#define FUNCID_NUM_WIDTH U(16)
|
|
|
|
#define FUNCID_MASK U(0xffffffff)
|
|
|
|
#define GET_SMC_NUM(id) (((id) >> FUNCID_NUM_SHIFT) & \
|
|
FUNCID_NUM_MASK)
|
|
#define GET_SMC_TYPE(id) (((id) >> FUNCID_TYPE_SHIFT) & \
|
|
FUNCID_TYPE_MASK)
|
|
#define GET_SMC_CC(id) (((id) >> FUNCID_CC_SHIFT) & \
|
|
FUNCID_CC_MASK)
|
|
#define GET_SMC_OEN(id) (((id) >> FUNCID_OEN_SHIFT) & \
|
|
FUNCID_OEN_MASK)
|
|
|
|
/*******************************************************************************
|
|
* SMCCC_ARCH_SOC_ID SoC version & revision bit definition
|
|
******************************************************************************/
|
|
#define SOC_ID_JEP_106_BANK_IDX_MASK GENMASK_32(30, 24)
|
|
#define SOC_ID_JEP_106_BANK_IDX_SHIFT U(24)
|
|
#define SOC_ID_JEP_106_ID_CODE_MASK GENMASK_32(23, 16)
|
|
#define SOC_ID_JEP_106_ID_CODE_SHIFT U(16)
|
|
#define SOC_ID_IMPL_DEF_MASK GENMASK_32(15, 0)
|
|
#define SOC_ID_IMPL_DEF_SHIFT U(0)
|
|
#define SOC_ID_SET_JEP_106(bkid, mfid) ((((bkid) << SOC_ID_JEP_106_BANK_IDX_SHIFT) & \
|
|
SOC_ID_JEP_106_BANK_IDX_MASK) | \
|
|
(((mfid) << SOC_ID_JEP_106_ID_CODE_SHIFT) & \
|
|
SOC_ID_JEP_106_ID_CODE_MASK))
|
|
|
|
#define SOC_ID_REV_MASK GENMASK_32(30, 0)
|
|
#define SOC_ID_REV_SHIFT U(0)
|
|
|
|
/*******************************************************************************
|
|
* Owning entity number definitions inside the function id as per the SMC
|
|
* calling convention
|
|
******************************************************************************/
|
|
#define OEN_ARM_START U(0)
|
|
#define OEN_ARM_END U(0)
|
|
#define OEN_CPU_START U(1)
|
|
#define OEN_CPU_END U(1)
|
|
#define OEN_SIP_START U(2)
|
|
#define OEN_SIP_END U(2)
|
|
#define OEN_OEM_START U(3)
|
|
#define OEN_OEM_END U(3)
|
|
#define OEN_STD_START U(4) /* Standard Service Calls */
|
|
#define OEN_STD_END U(4)
|
|
#define OEN_STD_HYP_START U(5) /* Standard Hypervisor Service calls */
|
|
#define OEN_STD_HYP_END U(5)
|
|
#define OEN_VEN_HYP_START U(6) /* Vendor Hypervisor Service calls */
|
|
#define OEN_VEN_HYP_END U(6)
|
|
#define OEN_TAP_START U(48) /* Trusted Applications */
|
|
#define OEN_TAP_END U(49)
|
|
#define OEN_TOS_START U(50) /* Trusted OS */
|
|
#define OEN_TOS_END U(63)
|
|
#define OEN_LIMIT U(64)
|
|
|
|
/* Flags and error codes */
|
|
#define SMC_64 U(1)
|
|
#define SMC_32 U(0)
|
|
|
|
#define SMC_TYPE_FAST UL(1)
|
|
#define SMC_TYPE_YIELD UL(0)
|
|
|
|
#define SMC_OK ULL(0)
|
|
#define SMC_UNK -1
|
|
#define SMC_PREEMPTED -2 /* Not defined by the SMCCC */
|
|
#define SMC_DENIED -3 /* Not defined by the SMCCC */
|
|
#define SMC_INVALID_PARAM -4 /* Not defined by the SMCCC */
|
|
|
|
/* Return codes for Arm Architecture Service SMC calls */
|
|
#define SMC_ARCH_CALL_SUCCESS 0
|
|
#define SMC_ARCH_CALL_NOT_SUPPORTED -1
|
|
#define SMC_ARCH_CALL_NOT_REQUIRED -2
|
|
#define SMC_ARCH_CALL_INVAL_PARAM -3
|
|
|
|
/*
|
|
* Various flags passed to SMC handlers
|
|
*
|
|
* Bit 5 and bit 0 of the flag are used to
|
|
* determine the source security state as
|
|
* follows:
|
|
* ---------------------------------
|
|
* Bit 5 | Bit 0 | Security state
|
|
* ---------------------------------
|
|
* 0 0 SMC_FROM_SECURE
|
|
* 0 1 SMC_FROM_NON_SECURE
|
|
* 1 1 SMC_FROM_REALM
|
|
*
|
|
* Bit 16 of flags records the caller's SMC
|
|
* SVE hint bit according to SMCCCv1.3.
|
|
* It can be consumed by dispatchers using
|
|
* is_sve_hint_set macro.
|
|
*
|
|
*/
|
|
|
|
#define SMC_FROM_SECURE (U(0) << 0)
|
|
#define SMC_FROM_NON_SECURE (U(1) << 0)
|
|
#define SMC_FROM_REALM U(0x21)
|
|
#define SMC_FROM_MASK U(0x21)
|
|
|
|
#ifndef __ASSEMBLER__
|
|
|
|
#include <stdint.h>
|
|
|
|
#include <lib/cassert.h>
|
|
|
|
#if ENABLE_RME
|
|
#define is_caller_non_secure(_f) (((_f) & SMC_FROM_MASK) \
|
|
== SMC_FROM_NON_SECURE)
|
|
#define is_caller_secure(_f) (((_f) & SMC_FROM_MASK) \
|
|
== SMC_FROM_SECURE)
|
|
#define is_caller_realm(_f) (((_f) & SMC_FROM_MASK) \
|
|
== SMC_FROM_REALM)
|
|
#define caller_sec_state(_f) ((_f) & SMC_FROM_MASK)
|
|
#else /* ENABLE_RME */
|
|
#define is_caller_non_secure(_f) (((_f) & SMC_FROM_NON_SECURE) != U(0))
|
|
#define is_caller_secure(_f) (!is_caller_non_secure(_f))
|
|
#endif /* ENABLE_RME */
|
|
|
|
#define is_sve_hint_set(_f) (((_f) & (FUNCID_SVE_HINT_MASK \
|
|
<< FUNCID_SVE_HINT_SHIFT)) != U(0))
|
|
|
|
/* The macro below is used to identify a Standard Service SMC call */
|
|
#define is_std_svc_call(_fid) (GET_SMC_OEN(_fid) == OEN_STD_START)
|
|
|
|
/* The macro below is used to identify a Arm Architectural Service SMC call */
|
|
#define is_arm_arch_svc_call(_fid) (GET_SMC_OEN(_fid) == OEN_ARM_START)
|
|
|
|
/* The macro below is used to identify a valid Fast SMC call */
|
|
#define is_valid_fast_smc(_fid) ((!(((_fid) >> 16) & U(0xff))) && \
|
|
(GET_SMC_TYPE(_fid) \
|
|
== (uint32_t)SMC_TYPE_FAST))
|
|
|
|
/*
|
|
* Macro to define UUID for services. Apart from defining and initializing a
|
|
* uuid_t structure, this macro verifies that the first word of the defined UUID
|
|
* does not equal SMC_UNK. This is to ensure that the caller won't mistake the
|
|
* returned UUID in x0 for an invalid SMC error return
|
|
*/
|
|
#define DEFINE_SVC_UUID2(_name, _tl, _tm, _th, _cl, _ch, \
|
|
_n0, _n1, _n2, _n3, _n4, _n5) \
|
|
CASSERT((uint32_t)(_tl) != (uint32_t)SMC_UNK, \
|
|
invalid_svc_uuid_##_name); \
|
|
static const uuid_t _name = { \
|
|
{((_tl) >> 24) & 0xFF, \
|
|
((_tl) >> 16) & 0xFF, \
|
|
((_tl) >> 8) & 0xFF, \
|
|
((_tl) & 0xFF)}, \
|
|
{((_tm) >> 8) & 0xFF, \
|
|
((_tm) & 0xFF)}, \
|
|
{((_th) >> 8) & 0xFF, \
|
|
((_th) & 0xFF)}, \
|
|
(_cl), (_ch), \
|
|
{ (_n0), (_n1), (_n2), (_n3), (_n4), (_n5) } \
|
|
}
|
|
|
|
/*
|
|
* Return a UUID in the SMC return registers.
|
|
*
|
|
* Acccording to section 5.3 of the SMCCC, UUIDs are returned as a single
|
|
* 128-bit value using the SMC32 calling convention. This value is mapped to
|
|
* argument registers x0-x3 on AArch64 (resp. r0-r3 on AArch32). x0 for example
|
|
* shall hold bytes 0 to 3, with byte 0 in the low-order bits.
|
|
*/
|
|
static inline uint32_t smc_uuid_word(uint8_t b0, uint8_t b1, uint8_t b2, uint8_t b3)
|
|
{
|
|
return ((uint32_t) b0) | (((uint32_t) b1) << 8) |
|
|
(((uint32_t) b2) << 16) | (((uint32_t) b3) << 24);
|
|
}
|
|
|
|
#define SMC_UUID_RET(_h, _uuid) \
|
|
SMC_RET4(handle, \
|
|
smc_uuid_word((_uuid).time_low[0], (_uuid).time_low[1], \
|
|
(_uuid).time_low[2], (_uuid).time_low[3]), \
|
|
smc_uuid_word((_uuid).time_mid[0], (_uuid).time_mid[1], \
|
|
(_uuid).time_hi_and_version[0], \
|
|
(_uuid).time_hi_and_version[1]), \
|
|
smc_uuid_word((_uuid).clock_seq_hi_and_reserved, \
|
|
(_uuid).clock_seq_low, (_uuid).node[0], \
|
|
(_uuid).node[1]), \
|
|
smc_uuid_word((_uuid).node[2], (_uuid).node[3], \
|
|
(_uuid).node[4], (_uuid).node[5]))
|
|
|
|
#endif /*__ASSEMBLER__*/
|
|
#endif /* SMCCC_H */
|