tee/optee/optee_ffa.h

1 /* SPDX-License-Identifier: BSD-2-Clause */
3  * Copyright (c) 2019-2021, 2023 Linaro Limited
7  * This file is exported by OP-TEE and is kept in sync between secure world
8  * and normal world drivers. We're using ARM FF-A 1.0 specification.
23  * defined in FF-A specification:
27  * w3-w7: Implementation defined, free to be used below
38  * Returns the API version implemented, currently follows the FF-A version.
41  * w4-w7: Not used (MBZ)
46  * w5-w7: Not used (MBZ)
51  * Returns the revision of OP-TEE.
53  * Used by non-secure world to figure out which version of the Trusted OS
59  * w4-w7: Unused (MBZ)
76  * w4-w7: Not used (MBZ)
89  * Secure world supports giving an offset into the argument shared memory
93 /* OP-TEE supports asynchronous notification via FF-A */
105  * w6-w7: Not used (MBZ)
109  * w4-w7: Note used (MBZ)
114  * Inform OP-TEE that the normal world is able to receive asynchronous
121  * w5-w7: Not used (MBZ)
125  * w4-w7: Note used (MBZ)
133  * with a zero internal offset and normal cached memory attributes.
136  * w4:    Lower 32 bits of a 64-bit Shared memory handle
137  * w5:    Upper 32 bits of a 64-bit Shared memory handle
138  * w6:    Offset into shared memory pointing to a struct optee_msg_arg
139  *	  right after the parameters of this struct (at offset
146  * Resume from RPC. Register usage:
148  * w4-w6: Not used (MBZ)
149  * w7:    Resume info
154  * w5-w7: Not used (MBZ)
159  * w5-w6: Not used (MBZ)
160  * w7:    Resume info
168  * FFA_BUSY:               Number of OP-TEE OS threads exceeded,
171  * FFA_INVALID_PARAMETER:  Bad shared memory handle or offset into the memory
174  * FFA_INVALID_PARAMETER:  Bad resume info