tee/optee/optee_smc.h

1 /* SPDX-License-Identifier: BSD-2-Clause */
3  * Copyright (c) 2015-2018, Linaro Limited
9 #include <linux/arm-smccc.h>
14  * https://github.com/OP-TEE/optee_os/blob/master/core/arch/arm/include/sm/optee_smc.h
35  * Normal cached memory (write-back), shareable for SMP systems and not
43  * 32-bit registers.
51  * 65cb6b93-af0c-4617-8ed6-644a8d1140f8
82  * Used by non-secure world to figure out which Trusted OS is installed.
85  * Returns UUID in a0-4 in the same way as OPTEE_SMC_CALLS_UID
95  * Used by non-secure world to figure out which version of the Trusted OS
99  * Returns revision in a0-1 in the same way as OPTEE_SMC_CALLS_REVISION
100  * described above. May optionally return a 32-bit build identifier in a2,
121  * a3	Cache settings, not used if physical pointer is in a predefined shared
122  *	memory area else per OPTEE_SMC_SHM_*
123  * a4-6	Not used
128  * a1-3	Not used
129  * a4-7	Preserved
133  * a1-3	Preserved
134  * a4-7	Preserved
138  * a1-2	RPC parameters
139  * a3-7	Resume information, must be preserved
160  * Get Shared Memory Config
162  * Returns the Secure/Non-secure shared memory config.
166  * a1-6	Not used
173  * a3	Cache settings of memory, as defined by the
175  * a4-7	Preserved
179  * a1-3 Not used
180  * a4-7	Preserved
199  * a2-6	Not used
205  * a2-7	Preserved
210  * a2-7 Preserved
214 /* Secure world has reserved shared memory for normal world to use */
216 /* Secure world can communicate via previously unregistered shared memory */
220  * Secure world supports commands "register/unregister shared memory",
221  * secure world accepts command buffers located in any parts of non-secure RAM
237  * Disable and empties cache of shared memory objects
239  * Secure world can cache frequently used shared memory objects, for
241  * function returns one shared memory reference to free. To disable the
247  * a1-6	Not used
252  * a1	Upper 32bit of a 64bit Shared memory cookie
253  * a2	Lower 32bit of a 64bit Shared memory cookie
254  * a3-7	Preserved
258  * a1-7	Preserved
262  * a1-7	Preserved
276  * Enable cache of shared memory objects
278  * Secure world can cache frequently used shared memory objects, for
285  * a1-6	Not used
290  * a1-7	Preserved
294  * a1-7	Preserved
305  * a1-3	Value of a1-3 when OPTEE_SMC_CALL_WITH_ARG returned
335  * Allocate memory for RPC parameter passing. The memory is used to hold a
340  * a1	Size in bytes of required argument memory
343  * a4-5	Not used
344  * a6-7	Resume information, must be preserved
349  *	memory, (a1 == 0 && a2 == 0) if size was 0 or if memory can't
352  *	memory, (a1 == 0 && a2 == 0) if size was 0 or if memory can't
355  * a4	Upper 32bits of 64bit Shared memory cookie used when freeing
356  *	the memory or doing an RPC
357  * a5	Lower 32bits of 64bit Shared memory cookie used when freeing
358  *	the memory or doing an RPC
359  * a6-7	Preserved
366  * Free memory previously allocated by OPTEE_SMC_RETURN_RPC_ALLOC
370  * a1	Upper 32bits of 64bit shared memory cookie belonging to this
371  *	argument memory
372  * a2	Lower 32bits of 64bit shared memory cookie belonging to this
373  *	argument memory
374  * a3-7	Resume information, must be preserved
378  * a1-2	Not used
379  * a3-7	Preserved
390  * a1-7	Resume information, must be preserved
394  * a1-7	Preserved
404  * - cmd		the Request ID
405  * - ret		return value of the request, filled in by normal world
406  * - num_params		number of parameters for the request
407  * - params		the parameters
408  * - param_attrs	attributes of the parameters
412  * a1	Upper 32bit of a 64bit Shared memory cookie holding a
415  * a2	Lower 32bit of a 64bit Shared memory cookie holding a
418  * a3-7	Resume information, must be preserved
422  * a1-2	Not used
423  * a3-7	Preserved