xref: /rk3399_ARM-atf/include/lib/smccc.h (revision 0c487ea42a8abb4062e26bfda42aacfd0fe84601)
1085e80ecSAntonio Nino Diaz /*
2085e80ecSAntonio Nino Diaz  * Copyright (c) 2016-2018, ARM Limited and Contributors. All rights reserved.
3085e80ecSAntonio Nino Diaz  *
4085e80ecSAntonio Nino Diaz  * SPDX-License-Identifier: BSD-3-Clause
5085e80ecSAntonio Nino Diaz  */
6085e80ecSAntonio Nino Diaz 
7085e80ecSAntonio Nino Diaz #ifndef __SMCCC_H__
8085e80ecSAntonio Nino Diaz #define __SMCCC_H__
9085e80ecSAntonio Nino Diaz 
10085e80ecSAntonio Nino Diaz #include <utils_def.h>
11085e80ecSAntonio Nino Diaz 
122f370465SAntonio Nino Diaz #define SMCCC_VERSION_MAJOR_SHIFT	U(16)
132f370465SAntonio Nino Diaz #define SMCCC_VERSION_MAJOR_MASK	U(0x7FFF)
142f370465SAntonio Nino Diaz #define SMCCC_VERSION_MINOR_SHIFT	U(0)
152f370465SAntonio Nino Diaz #define SMCCC_VERSION_MINOR_MASK	U(0xFFFF)
162f370465SAntonio Nino Diaz #define MAKE_SMCCC_VERSION(_major, _minor) \
17*0c487ea4SAntonio Nino Diaz 	((((uint32_t)(_major) & SMCCC_VERSION_MAJOR_MASK) << \
18*0c487ea4SAntonio Nino Diaz 						SMCCC_VERSION_MAJOR_SHIFT) \
19*0c487ea4SAntonio Nino Diaz 	| (((uint32_t)(_minor) & SMCCC_VERSION_MINOR_MASK) << \
20*0c487ea4SAntonio Nino Diaz 						SMCCC_VERSION_MINOR_SHIFT))
21085e80ecSAntonio Nino Diaz 
222f370465SAntonio Nino Diaz #if SMCCC_MAJOR_VERSION == 1
232f370465SAntonio Nino Diaz # define SMCCC_MINOR_VERSION U(1)
242f370465SAntonio Nino Diaz # include <smccc_v1.h>
252f370465SAntonio Nino Diaz #elif SMCCC_MAJOR_VERSION == 2
262f370465SAntonio Nino Diaz # define SMCCC_MINOR_VERSION U(0)
272f370465SAntonio Nino Diaz # include <smccc_v2.h>
282f370465SAntonio Nino Diaz #else
292f370465SAntonio Nino Diaz # error "Unsupported version of SMCCC."
30085e80ecSAntonio Nino Diaz #endif
312f370465SAntonio Nino Diaz 
322f370465SAntonio Nino Diaz /* Various flags passed to SMC handlers */
332f370465SAntonio Nino Diaz #define SMC_FROM_SECURE		(U(0) << 0)
342f370465SAntonio Nino Diaz #define SMC_FROM_NON_SECURE	(U(1) << 0)
35085e80ecSAntonio Nino Diaz 
36085e80ecSAntonio Nino Diaz #ifndef __ASSEMBLY__
37085e80ecSAntonio Nino Diaz 
38085e80ecSAntonio Nino Diaz #include <cassert.h>
39085e80ecSAntonio Nino Diaz #include <stdint.h>
40085e80ecSAntonio Nino Diaz 
41b3323cd6SAntonio Nino Diaz #define is_caller_non_secure(_f)	(((_f) & SMC_FROM_NON_SECURE) != U(0))
42b3323cd6SAntonio Nino Diaz #define is_caller_secure(_f)		(!is_caller_non_secure(_f))
43085e80ecSAntonio Nino Diaz 
44085e80ecSAntonio Nino Diaz /* The macro below is used to identify a Standard Service SMC call */
452f370465SAntonio Nino Diaz #define is_std_svc_call(_fid)		(GET_SMC_OEN(_fid) == OEN_STD_START)
46085e80ecSAntonio Nino Diaz 
47085e80ecSAntonio Nino Diaz /* The macro below is used to identify a Arm Architectural Service SMC call */
482f370465SAntonio Nino Diaz #define is_arm_arch_svc_call(_fid)	(GET_SMC_OEN(_fid) == OEN_ARM_START)
49085e80ecSAntonio Nino Diaz 
50085e80ecSAntonio Nino Diaz /* The macro below is used to identify a valid Fast SMC call */
51085e80ecSAntonio Nino Diaz #define is_valid_fast_smc(_fid)		((!(((_fid) >> 16) & U(0xff))) && \
52085e80ecSAntonio Nino Diaz 					   (GET_SMC_TYPE(_fid) == SMC_TYPE_FAST))
53085e80ecSAntonio Nino Diaz 
54085e80ecSAntonio Nino Diaz /*
55085e80ecSAntonio Nino Diaz  * Macro to define UUID for services. Apart from defining and initializing a
56085e80ecSAntonio Nino Diaz  * uuid_t structure, this macro verifies that the first word of the defined UUID
57085e80ecSAntonio Nino Diaz  * does not equal SMC_UNK. This is to ensure that the caller won't mistake the
58085e80ecSAntonio Nino Diaz  * returned UUID in x0 for an invalid SMC error return
59085e80ecSAntonio Nino Diaz  */
60085e80ecSAntonio Nino Diaz #define DEFINE_SVC_UUID(_name, _tl, _tm, _th, _cl, _ch, \
61085e80ecSAntonio Nino Diaz 		_n0, _n1, _n2, _n3, _n4, _n5) \
62085e80ecSAntonio Nino Diaz 	CASSERT((uint32_t)(_tl) != (uint32_t) SMC_UNK, invalid_svc_uuid);\
63085e80ecSAntonio Nino Diaz 	static const uuid_t _name = { \
64085e80ecSAntonio Nino Diaz 		_tl, _tm, _th, _cl, _ch, \
65085e80ecSAntonio Nino Diaz 		{ _n0, _n1, _n2, _n3, _n4, _n5 } \
66085e80ecSAntonio Nino Diaz 	}
67085e80ecSAntonio Nino Diaz 
68085e80ecSAntonio Nino Diaz #endif /*__ASSEMBLY__*/
69085e80ecSAntonio Nino Diaz #endif /* __SMCCC_H__ */
70