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 */
95 /* OP-TEE supports probing for RPMB device if needed */
107  * w6-w7: Not used (MBZ)
111  * w4-w7: Note used (MBZ)
116  * Inform OP-TEE that the normal world is able to receive asynchronous
123  * w5-w7: Not used (MBZ)
127  * w4-w7: Note used (MBZ)
135  * with a zero internal offset and normal cached memory attributes.
138  * w4:    Lower 32 bits of a 64-bit Shared memory handle
139  * w5:    Upper 32 bits of a 64-bit Shared memory handle
140  * w6:    Offset into shared memory pointing to a struct optee_msg_arg
141  *	  right after the parameters of this struct (at offset
148  * Resume from RPC. Register usage:
150  * w4-w6: Not used (MBZ)
151  * w7:    Resume info
156  * w5-w7: Not used (MBZ)
161  * w5-w6: Not used (MBZ)
162  * w7:    Resume info
170  * FFA_BUSY:               Number of OP-TEE OS threads exceeded,
173  * FFA_INVALID_PARAMETER:  Bad shared memory handle or offset into the memory
176  * FFA_INVALID_PARAMETER:  Bad resume info