1 /* SPDX-License-Identifier: MIT */
2
3 /*
4 * Copyright 2019 Advanced Micro Devices, Inc.
5 */
6
7 #ifndef AMDTEE_PRIVATE_H
8 #define AMDTEE_PRIVATE_H
9
10 #include <linux/mutex.h>
11 #include <linux/spinlock.h>
12 #include <linux/tee_core.h>
13 #include <linux/kref.h>
14 #include <linux/types.h>
15 #include "amdtee_if.h"
16
17 #define DRIVER_NAME "amdtee"
18 #define DRIVER_AUTHOR "AMD-TEE Linux driver team"
19
20 /* Some GlobalPlatform error codes used in this driver */
21 #define TEEC_SUCCESS 0x00000000
22 #define TEEC_ERROR_GENERIC 0xFFFF0000
23 #define TEEC_ERROR_BAD_PARAMETERS 0xFFFF0006
24 #define TEEC_ERROR_OUT_OF_MEMORY 0xFFFF000C
25 #define TEEC_ERROR_COMMUNICATION 0xFFFF000E
26
27 #define TEEC_ORIGIN_COMMS 0x00000002
28
29 /* Maximum number of sessions which can be opened with a Trusted Application */
30 #define TEE_NUM_SESSIONS 32
31
32 #define TA_LOAD_PATH "/amdtee"
33 #define TA_PATH_MAX 60
34
35 /**
36 * struct amdtee - main service struct
37 * @teedev: client device
38 * @pool: shared memory pool
39 */
40 struct amdtee {
41 struct tee_device *teedev;
42 struct tee_shm_pool *pool;
43 };
44
45 /**
46 * struct amdtee_session - Trusted Application (TA) session related information.
47 * @ta_handle: handle to Trusted Application (TA) loaded in TEE environment
48 * @refcount: counter to keep track of sessions opened for the TA instance
49 * @session_info: an array pointing to TA allocated session data.
50 * @sess_mask: session usage bit-mask. If a particular bit is set, then the
51 * corresponding @session_info entry is in use or valid.
52 *
53 * Session structure is updated on open_session and this information is used for
54 * subsequent operations with the Trusted Application.
55 */
56 struct amdtee_session {
57 struct list_head list_node;
58 u32 ta_handle;
59 struct kref refcount;
60 u32 session_info[TEE_NUM_SESSIONS];
61 DECLARE_BITMAP(sess_mask, TEE_NUM_SESSIONS);
62 spinlock_t lock; /* synchronizes access to @sess_mask */
63 };
64
65 /**
66 * struct amdtee_context_data - AMD-TEE driver context data
67 * @sess_list: Keeps track of sessions opened in current TEE context
68 * @shm_list: Keeps track of buffers allocated and mapped in current TEE
69 * context
70 */
71 struct amdtee_context_data {
72 struct list_head sess_list;
73 struct list_head shm_list;
74 struct mutex shm_mutex; /* synchronizes access to @shm_list */
75 };
76
77 struct amdtee_driver_data {
78 struct amdtee *amdtee;
79 };
80
81 struct shmem_desc {
82 void *kaddr;
83 u64 size;
84 };
85
86 /**
87 * struct amdtee_shm_data - Shared memory data
88 * @kaddr: Kernel virtual address of shared memory
89 * @buf_id: Buffer id of memory mapped by TEE_CMD_ID_MAP_SHARED_MEM
90 */
91 struct amdtee_shm_data {
92 struct list_head shm_node;
93 void *kaddr;
94 u32 buf_id;
95 };
96
97 /**
98 * struct amdtee_ta_data - Keeps track of all TAs loaded in AMD Secure
99 * Processor
100 * @ta_handle: Handle to TA loaded in TEE
101 * @refcount: Reference count for the loaded TA
102 */
103 struct amdtee_ta_data {
104 struct list_head list_node;
105 u32 ta_handle;
106 u32 refcount;
107 };
108
109 #define LOWER_TWO_BYTE_MASK 0x0000FFFF
110
111 /**
112 * set_session_id() - Sets the session identifier.
113 * @ta_handle: [in] handle of the loaded Trusted Application (TA)
114 * @session_index: [in] Session index. Range: 0 to (TEE_NUM_SESSIONS - 1).
115 * @session: [out] Pointer to session id
116 *
117 * Lower two bytes of the session identifier represents the TA handle and the
118 * upper two bytes is session index.
119 */
set_session_id(u32 ta_handle,u32 session_index,u32 * session)120 static inline void set_session_id(u32 ta_handle, u32 session_index,
121 u32 *session)
122 {
123 *session = (session_index << 16) | (LOWER_TWO_BYTE_MASK & ta_handle);
124 }
125
get_ta_handle(u32 session)126 static inline u32 get_ta_handle(u32 session)
127 {
128 return session & LOWER_TWO_BYTE_MASK;
129 }
130
get_session_index(u32 session)131 static inline u32 get_session_index(u32 session)
132 {
133 return (session >> 16) & LOWER_TWO_BYTE_MASK;
134 }
135
136 int amdtee_open_session(struct tee_context *ctx,
137 struct tee_ioctl_open_session_arg *arg,
138 struct tee_param *param);
139
140 int amdtee_close_session(struct tee_context *ctx, u32 session);
141
142 int amdtee_invoke_func(struct tee_context *ctx,
143 struct tee_ioctl_invoke_arg *arg,
144 struct tee_param *param);
145
146 int amdtee_cancel_req(struct tee_context *ctx, u32 cancel_id, u32 session);
147
148 int amdtee_map_shmem(struct tee_shm *shm);
149
150 void amdtee_unmap_shmem(struct tee_shm *shm);
151
152 int handle_load_ta(void *data, u32 size,
153 struct tee_ioctl_open_session_arg *arg);
154
155 int handle_unload_ta(u32 ta_handle);
156
157 int handle_open_session(struct tee_ioctl_open_session_arg *arg, u32 *info,
158 struct tee_param *p);
159
160 int handle_close_session(u32 ta_handle, u32 info);
161
162 int handle_map_shmem(u32 count, struct shmem_desc *start, u32 *buf_id);
163
164 void handle_unmap_shmem(u32 buf_id);
165
166 int handle_invoke_cmd(struct tee_ioctl_invoke_arg *arg, u32 sinfo,
167 struct tee_param *p);
168
169 struct tee_shm_pool *amdtee_config_shm(void);
170
171 u32 get_buffer_id(struct tee_shm *shm);
172 #endif /*AMDTEE_PRIVATE_H*/
173