/* SPDX-License-Identifier: MIT */ /* * Copyright (C) 2019,2021 Advanced Micro Devices, Inc. * * Author: Rijo Thomas <[email protected]> * Author: Devaraj Rangasamy <[email protected]> * */ /* This file describes the TEE communication interface between host and AMD * Secure Processor */ #ifndef __TEE_DEV_H__ #define __TEE_DEV_H__ #include <linux/device.h> #include <linux/mutex.h> #define TEE_DEFAULT_CMD_TIMEOUT … #define TEE_DEFAULT_RING_TIMEOUT … #define MAX_BUFFER_SIZE … /** * struct tee_init_ring_cmd - Command to init TEE ring buffer * @low_addr: bits [31:0] of the physical address of ring buffer * @hi_addr: bits [63:32] of the physical address of ring buffer * @size: size of ring buffer in bytes */ struct tee_init_ring_cmd { … }; #define MAX_RING_BUFFER_ENTRIES … /** * struct ring_buf_manager - Helper structure to manage ring buffer. * @ring_start: starting address of ring buffer * @ring_size: size of ring buffer in bytes * @ring_pa: physical address of ring buffer * @wptr: index to the last written entry in ring buffer */ struct ring_buf_manager { … }; struct psp_tee_device { … }; /** * enum tee_cmd_state - TEE command states for the ring buffer interface * @TEE_CMD_STATE_INIT: initial state of command when sent from host * @TEE_CMD_STATE_PROCESS: command being processed by TEE environment * @TEE_CMD_STATE_COMPLETED: command processing completed */ enum tee_cmd_state { … }; /** * enum cmd_resp_state - TEE command's response status maintained by driver * @CMD_RESPONSE_INVALID: initial state when no command is written to ring * @CMD_WAITING_FOR_RESPONSE: driver waiting for response from TEE * @CMD_RESPONSE_TIMEDOUT: failed to get response from TEE * @CMD_RESPONSE_COPIED: driver has copied response from TEE */ enum cmd_resp_state { … }; /** * struct tee_ring_cmd - Structure of the command buffer in TEE ring * @cmd_id: refers to &enum tee_cmd_id. Command id for the ring buffer * interface * @cmd_state: refers to &enum tee_cmd_state * @status: status of TEE command execution * @res0: reserved region * @pdata: private data (currently unused) * @res1: reserved region * @buf: TEE command specific buffer * @flag: refers to &enum cmd_resp_state */ struct tee_ring_cmd { … } __packed; int tee_dev_init(struct psp_device *psp); void tee_dev_destroy(struct psp_device *psp); #endif /* __TEE_DEV_H__ */