u-boot/include/tee.h

1 /* SPDX-License-Identifier: GPL-2.0+ */
12 #define TEE_GEN_CAP_REG_MEM     BIT(1)	/* Supports registering shared memory */
14 #define TEE_SHM_REGISTER	BIT(0)	/* In list of shared memory */
15 #define TEE_SHM_SEC_REGISTER	BIT(1)	/* TEE notified of this memory */
16 #define TEE_SHM_ALLOC		BIT(2)	/* The memory is malloced() and must */
55  * struct tee_optee_ta_uuid - OP-TEE Trusted Application (TA) UUID format
57  * Used to identify an OP-TEE TA and define suitable to initialize structs
60  * OP-TEE. See RFC4122 for details on the format.
70  * struct tee_shm - memory shared with the TEE
73  * @addr:	Pointer to the shared memory
74  * @size:	Size of the the shared memory
86  * struct tee_param_memref - memory reference for a Trusted Application
87  * @shm_offs:	Offset in bytes into the shared memory object @shm
88  * @size:	Size in bytes of the memory reference
89  * @shm:	Pointer to a shared memory object for the buffer
100  * struct tee_param_value - value parameter for a Trusted Application
112  * struct tee_param - invoke parameter for a Trusted Application
120  * flexibility both value parameters and memory refereces can be used.
131  * struct tee_open_session_arg - extra arguments for tee_open_session()
149  * struct tee_invoke_arg - extra arguments for tee_invoke_func()
163  * struct tee_version_data - description of TEE
171  * struct tee_driver_ops - TEE driver operations
176  * @shm_register:	Registers memory shared with the TEE
177  * @shm_unregister:	Unregisters memory shared with the TEE
181 	 * get_version() - Query capabilities of TEE device
187 	 * open_session() - Open a session to a Trusted Application
193 	 * Returns < 0 on error else see @arg->ret for result. If @arg->ret is
194 	 * TEE_SUCCESS the session identifier is available in @arg->session.
200 	 * close_session() - Close a session to a Trusted Application
209 	 * tee_invoke_func() - Invoke a function in a Trusted Application
215 	 * Returns < 0 on error else see @arg->ret for result.
220 	 * shm_register() - Registers memory shared with the TEE
222 	 * @shm:	Pointer to a shared memory object
227 	 * shm_unregister() - Unregisters memory shared with the TEE
229 	 * @shm:	Pointer to a shared memory object
236  * __tee_shm_add() - Internal helper function to register shared memory
238  * @align:	Required alignment of allocated memory block if
240  * @addr:	Address of memory block, ignored if (@flags & TEE_SHM_ALLOC)
241  * @size:	Size of memory block
252  * tee_shm_alloc() - Allocate shared memory
254  * @size:	Size of memory block
265  * tee_shm_register() - Registers shared memory
267  * @addr:	Address of memory block
268  * @size:	Size of memory block
279  * tee_shm_free() - Frees shared memory
280  * @shm:	Shared memory object
285  * tee_shm_is_registered() - Check register status of shared memory object
286  * @shm:	Pointer to shared memory object
289  * Returns true if the shared memory object is registered for the supplied
295  * tee_find_device() - Look up a TEE device
312  * tee_get_version() - Query capabilities of TEE device
319  * tee_open_session() - Open a session to a Trusted Application
325  * Returns < 0 on error else see @arg->ret for result. If @arg->ret is
326  * TEE_SUCCESS the session identifier is available in @arg->session.
332  * tee_close_session() - Close a session to a Trusted Application
342  * tee_invoke_func() - Invoke a function in a Trusted Application
348  * Returns < 0 on error else see @arg->ret for result.
354  * tee_optee_ta_uuid_from_octets() - Converts to struct tee_optee_ta_uuid
365  * tee_optee_ta_uuid_to_octets() - Converts from struct tee_optee_ta_uuid