/* SPDX-License-Identifier: MIT */ /* * Copyright 2019 Advanced Micro Devices, Inc. */ /* * This file has definitions related to Host and AMD-TEE Trusted OS interface. * These definitions must match the definitions on the TEE side. */ #ifndef AMDTEE_IF_H #define AMDTEE_IF_H #include <linux/types.h> /***************************************************************************** ** TEE Param ******************************************************************************/ #define TEE_MAX_PARAMS … /** * struct memref - memory reference structure * @buf_id: buffer ID of the buffer mapped by TEE_CMD_ID_MAP_SHARED_MEM * @offset: offset in bytes from beginning of the buffer * @size: data size in bytes */ struct memref { … }; struct value { … }; /* * Parameters passed to open_session or invoke_command */ tee_op_param; struct tee_operation { … }; /* Must be same as in GP TEE specification */ #define TEE_OP_PARAM_TYPE_NONE … #define TEE_OP_PARAM_TYPE_VALUE_INPUT … #define TEE_OP_PARAM_TYPE_VALUE_OUTPUT … #define TEE_OP_PARAM_TYPE_VALUE_INOUT … #define TEE_OP_PARAM_TYPE_INVALID … #define TEE_OP_PARAM_TYPE_MEMREF_INPUT … #define TEE_OP_PARAM_TYPE_MEMREF_OUTPUT … #define TEE_OP_PARAM_TYPE_MEMREF_INOUT … #define TEE_PARAM_TYPE_GET(t, i) … #define TEE_PARAM_TYPES(t0, t1, t2, t3) … /***************************************************************************** ** TEE Commands *****************************************************************************/ /* * The shared memory between rich world and secure world may be physically * non-contiguous. Below structures are meant to describe a shared memory region * via scatter/gather (sg) list */ /** * struct tee_sg_desc - sg descriptor for a physically contiguous buffer * @low_addr: [in] bits[31:0] of buffer's physical address. Must be 4KB aligned * @hi_addr: [in] bits[63:32] of the buffer's physical address * @size: [in] size in bytes (must be multiple of 4KB) */ struct tee_sg_desc { … }; /** * struct tee_sg_list - structure describing a scatter/gather list * @count: [in] number of sg descriptors * @size: [in] total size of all buffers in the list. Must be multiple of 4KB * @buf: [in] list of sg buffer descriptors */ #define TEE_MAX_SG_DESC … struct tee_sg_list { … }; /** * struct tee_cmd_map_shared_mem - command to map shared memory * @buf_id: [out] return buffer ID value * @sg_list: [in] list describing memory to be mapped */ struct tee_cmd_map_shared_mem { … }; /** * struct tee_cmd_unmap_shared_mem - command to unmap shared memory * @buf_id: [in] buffer ID of memory to be unmapped */ struct tee_cmd_unmap_shared_mem { … }; /** * struct tee_cmd_load_ta - load Trusted Application (TA) binary into TEE * @low_addr: [in] bits [31:0] of the physical address of the TA binary * @hi_addr: [in] bits [63:32] of the physical address of the TA binary * @size: [in] size of TA binary in bytes * @ta_handle: [out] return handle of the loaded TA * @return_origin: [out] origin of return code after TEE processing */ struct tee_cmd_load_ta { … }; /** * struct tee_cmd_unload_ta - command to unload TA binary from TEE environment * @ta_handle: [in] handle of the loaded TA to be unloaded */ struct tee_cmd_unload_ta { … }; /** * struct tee_cmd_open_session - command to call TA_OpenSessionEntryPoint in TA * @ta_handle: [in] handle of the loaded TA * @session_info: [out] pointer to TA allocated session data * @op: [in/out] operation parameters * @return_origin: [out] origin of return code after TEE processing */ struct tee_cmd_open_session { … }; /** * struct tee_cmd_close_session - command to call TA_CloseSessionEntryPoint() * in TA * @ta_handle: [in] handle of the loaded TA * @session_info: [in] pointer to TA allocated session data */ struct tee_cmd_close_session { … }; /** * struct tee_cmd_invoke_cmd - command to call TA_InvokeCommandEntryPoint() in * TA * @ta_handle: [in] handle of the loaded TA * @cmd_id: [in] TA command ID * @session_info: [in] pointer to TA allocated session data * @op: [in/out] operation parameters * @return_origin: [out] origin of return code after TEE processing */ struct tee_cmd_invoke_cmd { … }; #endif /*AMDTEE_IF_H*/
Codebase Browser
linux