include/optee_include/teesmc.h

4  * SPDX-License-Identifier:     GPL-2.0+
16  * (secure world OS and normal world Linux kernel to start with) where
33  * a trusted OS in secure world.
39  * Part 1 - passing parameters to Trusted Applications
57  * Meta parameter to be absorbed by the Secure OS and not passed
89  * struct teesmc32_param_memref - memory reference
93  * Secure and normal world communicates pointer via physical address instead of
95  * Secure and normal world has completely independant memory mapping. Normal
98  * before passing the structure to secure world.
106  * struct teesmc32_param_memref - memory reference
118  * struct teesmc32_param_value - values
128  * struct teesmc64_param_value - values
138  * struct teesmc32_param - parameter
157  * struct teesmc64_param - parameter
173  * struct teesmc32_arg - SMC argument for Trusted OS
210  * struct teesmc64_arg - SMC argument for Trusted OS
241  * TEESMC64_GET_PARAMS - return pointer to union teesmc64_param *
245  * Returns a pointer to the params[] inside a struct teesmc64_arg.
251  * TEESMC64_GET_ARG_SIZE - return size of struct teesmc64_arg
265  * struct teesmc_meta_open_session - additional parameters for
289  * Part 2 - low level SMC interaction
339  * 65cb6b93-af0c-4617-8ed6-644a8d1140f8 : Only 32 bit calls are supported
340  * 65cb6b93-af0c-4617-8ed6-644a8d1140f9 : Both 32 and 64 bit calls are supported
369  * Used by non-secure world to figure out which Trusted OS is installed.
372  * Returns UUID in r0-4/w0-4 in the same way as TEESMC32_CALLS_UID
383  * Used by non-secure world to figure out which version of the Trusted OS
387  * Returns revision in r0-1/w0-1 in the same way as TEESMC32_CALLS_REVISION
403  * r2-6/x2-6	Not used
408  * r1-3/x1-3	Not used
409  * r4-7/x4-7	Preserved
413  * r1-3/x1-3	Preserved
414  * r4-7/x4-7	Preserved
418  * r1-2/x1-2	RPC parameters
419  * r3-7/x3-7	Resume information, must be preserved
464  * r1-3/x1-3	Value of r1-3/x1-3 when TEESMC32_CALL_WITH_ARG returned
519  * r2-7/x2-7	Resume information, must be preserved
527  * r2-7/x2-7	Preserved
541  * r2-7/x2-7	Resume information, must be preserved
549  * r2-7/x2-7	Preserved
561  * r2-7/x2-7	Resume information, must be preserved
568  * r2-7/x2-7	Preserved
579  * r3-7/x3-7	Resume information, must be preserved
585  * r1-2/x1-2	Not used
586  * r3-7/x3-7	Preserved
597  * r1-7/x1-7	Resume information, must be preserved
603  * r1-7/x1-7	Preserved
612  * - cmd		the Request ID
613  * - ret		return value of the request, filled in by normal world
614  * - num_params		number of parameters for the request
615  * - params		the parameters
616  * - param_attrs	attributes of the parameters
624  * r2-7/x2-7	Resume information, must be preserved
630  * r1-7/x1-7	Preserved