tee/optee/optee_smc.h

1 /* SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause) */
3  * Copyright (c) 2015-2019, Linaro Limited
8 #include <linux/arm-smccc.h>
28  * Normal cached memory (write-back), shareable for SMP systems and not
36  * 32-bit registers.
42  * Return one of the following UIDs if using API specified in this file
44  * 65cb6b93-af0c-4617-8ed6-644a8d1140f8
56  * Returns 2.0 if using API specified in this file without further extentions.
75  * Used by non-secure world to figure out which Trusted OS is installed.
78  * Returns UUID in a0-4 in the same way as OPTEE_SMC_CALLS_UID
88  * Used by non-secure world to figure out which version of the Trusted OS
92  * Returns revision in a0-1 in the same way as OPTEE_SMC_CALLS_REVISION
93  * described above. May optionally return a 32-bit build identifier in a2,
114  * a3	Cache settings, not used if physical pointer is in a predefined shared
116  * a4-6	Not used
121  * a1-3	Not used
122  * a4-7	Preserved
126  * a1-3	Preserved
127  * a4-7	Preserved
129  * RPC return register usage:
131  * a1-2	RPC parameters
132  * a3-7	Resume information, must be preserved
145  * OPTEE_SMC_RETURN_IS_RPC()		Call suspended by RPC call to normal
155  * Returns the Secure/Non-secure shared memory config.
159  * a1-6	Not used
168  * a4-7	Preserved
172  * a1-3 Not used
173  * a4-7	Preserved
192  * a2-6	Not used
198  * a2-7	Preserved
203  * a2-7 Preserved
214  * secure world accepts command buffers located in any parts of non-secure RAM
236  * example objects used as RPC arguments. When secure world is idle this
243  * a1-6	Not used
250  * a3-7	Preserved
254  * a1-7	Preserved
258  * a1-7	Preserved
275  * example objects used as RPC arguments. When secure world is idle this
276  * function returns OPTEE_SMC_RETURN_OK and the cache is enabled. If
281  * a1-6	Not used
286  * a1-7	Preserved
290  * a1-7	Preserved
297  * Resume from RPC (for example after processing a foreign interrupt)
301  * a1-3	Value of a1-3 when OPTEE_SMC_CALL_WITH_ARG returned
312  * OPTEE_SMC_RETURN_RPC			Call suspended by RPC call to normal
331  * Allocate memory for RPC parameter passing. The memory is used to hold a
339  * a4-5	Not used
340  * a6-7	Resume information, must be preserved
345  *	memory, (a1 == 0 && a2 == 0) if size was 0 or if memory can't
348  *	memory, (a1 == 0 && a2 == 0) if size was 0 or if memory can't
352  *	the memory or doing an RPC
354  *	the memory or doing an RPC
355  * a6-7	Preserved
370  * a3-7	Resume information, must be preserved
374  * a1-2	Not used
375  * a3-7	Preserved
386  * a1-7	Resume information, must be preserved
390  * a1-7	Preserved
397  * Do an RPC request. The supplied struct optee_msg_arg tells which
400  * - cmd		the Request ID
401  * - ret		return value of the request, filled in by normal world
402  * - num_params		number of parameters for the request
403  * - params		the parameters
404  * - param_attrs	attributes of the parameters
414  * a3-7	Resume information, must be preserved
418  * a1-2	Not used
419  * a3-7	Preserved