xref: /freebsd/sys/dev/psci/smccc.h (revision f6a3b357e9be4c6423c85eff9a847163a0d307c8)
1 /*-
2  * SPDX-License-Identifier: BSD-2-Clause
3  *
4  * Copyright (c) 2018 Andrew Turner
5  *
6  * This software was developed by SRI International and the University of
7  * Cambridge Computer Laboratory under DARPA/AFRL contract FA8750-10-C-0237
8  * ("CTSRD"), as part of the DARPA CRASH research programme.
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions
12  * are met:
13  * 1. Redistributions of source code must retain the above copyright
14  *    notice, this list of conditions and the following disclaimer.
15  * 2. Redistributions in binary form must reproduce the above copyright
16  *    notice, this list of conditions and the following disclaimer in the
17  *    documentation and/or other materials provided with the distribution.
18  *
19  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
20  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
23  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29  * SUCH DAMAGE.
30  *
31  * $FreeBSD$
32  */
33 
34 #ifndef	_PSCI_SMCCC_H_
35 #define	_PSCI_SMCCC_H_
36 
37 #define	SMCCC_VERSION_MAJOR(ver)	(((ver) >> 16) & 0x7fff)
38 #define	SMCCC_VERSION_MINOR(ver)	((ver) & 0xffff)
39 
40 #define	SMCCC_FUNC_ID(type, call_conv, range, func)	\
41 	(((type) << 31) |				\
42 	 ((call_conv) << 30) |				\
43 	 (((range) & 0x3f) << 24) |				\
44 	 ((func) & 0xffff))
45 
46 #define	SMCCC_YIELDING_CALL	0
47 #define	SMCCC_FAST_CALL		1
48 
49 #define	SMCCC_32BIT_CALL	0
50 #define	SMCCC_64BIT_CALL	1
51 
52 /*
53  * Arm Architecture Calls.
54  * These are documented in the document ARM DEN 0070A.
55  */
56 #define	SMCCC_VERSION							\
57     SMCCC_FUNC_ID(SMCCC_FAST_CALL, SMCCC_32BIT_CALL, 0, 0)
58 #define	SMCCC_ARCH_FEATURES						\
59     SMCCC_FUNC_ID(SMCCC_FAST_CALL, SMCCC_32BIT_CALL, 0, 1)
60 #define	SMCCC_ARCH_WORKAROUND_1						\
61     SMCCC_FUNC_ID(SMCCC_FAST_CALL, SMCCC_32BIT_CALL, 0, 0x8000)
62 #define	SMCCC_ARCH_WORKAROUND_2						\
63     SMCCC_FUNC_ID(SMCCC_FAST_CALL, SMCCC_32BIT_CALL, 0, 0x7fff)
64 
65 /* The return values from ARM DEN 0070A. */
66 #define	SMCCC_RET_SUCCESS		0
67 #define	SMCCC_RET_NOT_SUPPORTED		-1
68 #define	SMCCC_RET_NOT_REQUIRED		-2
69 
70 int32_t smccc_arch_features(uint32_t);
71 int smccc_arch_workaround_1(void);
72 int smccc_arch_workaround_2(int);
73 
74 
75 #endif /* _PSCI_SMCCC_H_ */
76