u-boot/include/tee.h

1 /* SPDX-License-Identifier: GPL-2.0+ */
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
71  * @dev:	The TEE device
78 	struct udevice *dev;  member
86  * struct tee_param_memref - memory reference for a Trusted Application
100  * struct tee_param_value - value parameter for a Trusted Application
112  * struct tee_param - invoke parameter for a Trusted Application
131  * struct tee_open_session_arg - extra arguments for tee_open_session()
132  * @uuid:	[in] UUID of the Trusted Application
140 	u8 uuid[TEE_UUID_LEN];  member
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
181 	 * get_version() - Query capabilities of TEE device
182 	 * @dev:	The TEE device
185 	void (*get_version)(struct udevice *dev, struct tee_version_data *vers);
187 	 * open_session() - Open a session to a Trusted Application
188 	 * @dev:	The TEE device
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.
196 	int (*open_session)(struct udevice *dev,
200 	 * close_session() - Close a session to a Trusted Application
201 	 * @dev:	The TEE device
207 	int (*close_session)(struct udevice *dev, u32 session);
209 	 * tee_invoke_func() - Invoke a function in a Trusted Application
210 	 * @dev:	The TEE device
215 	 * Returns < 0 on error else see @arg->ret for result.
217 	int (*invoke_func)(struct udevice *dev, struct tee_invoke_arg *arg,
220 	 * shm_register() - Registers memory shared with the TEE
221 	 * @dev:	The TEE device
225 	int (*shm_register)(struct udevice *dev, struct tee_shm *shm);
227 	 * shm_unregister() - Unregisters memory shared with the TEE
228 	 * @dev:	The TEE device
232 	int (*shm_unregister)(struct udevice *dev, struct tee_shm *shm);
236  * __tee_shm_add() - Internal helper function to register shared memory
237  * @dev:	The TEE device
248 int __tee_shm_add(struct udevice *dev, ulong align, void *addr, ulong size,
252  * tee_shm_alloc() - Allocate shared memory
253  * @dev:	The TEE device
261 int tee_shm_alloc(struct udevice *dev, ulong size, u32 flags,
265  * tee_shm_register() - Registers shared memory
266  * @dev:	The TEE device
275 int tee_shm_register(struct udevice *dev, void *addr, ulong size, u32 flags,
279  * tee_shm_free() - Frees shared memory
285  * tee_shm_is_registered() - Check register status of shared memory object
287  * @dev:	The TEE device
292 bool tee_shm_is_registered(struct tee_shm *shm, struct udevice *dev);
295  * tee_find_device() - Look up a TEE device
312  * tee_get_version() - Query capabilities of TEE device
313  * @dev:	The TEE device
316 void tee_get_version(struct udevice *dev, struct tee_version_data *vers);
319  * tee_open_session() - Open a session to a Trusted Application
320  * @dev:	The TEE device
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.
328 int tee_open_session(struct udevice *dev, struct tee_open_session_arg *arg,
332  * tee_close_session() - Close a session to a Trusted Application
333  * @dev:	The TEE device
339 int tee_close_session(struct udevice *dev, u32 session);
342  * tee_invoke_func() - Invoke a function in a Trusted Application
343  * @dev:	The TEE device
348  * Returns < 0 on error else see @arg->ret for result.
350 int tee_invoke_func(struct udevice *dev, struct tee_invoke_arg *arg,
354  * tee_optee_ta_uuid_from_octets() - Converts to struct tee_optee_ta_uuid
356  * @s:	Source UUID octets
365  * tee_optee_ta_uuid_to_octets() - Converts from struct tee_optee_ta_uuid
366  * @d:	Destination UUID octets