TEE driver for AMD APUs
Subsystems (3)
v2 cover TEE driver for AMD APUs
This patch series introduces Trusted Execution Environment (TEE) driver for AMD APU enabled systems. The TEE is a secure area of a processor which ensures that sensitive data is stored, processed and protected in an isolated and trusted environment. The AMD Secure Processor is a dedicated processor which provides TEE to enable HW platform security. It offers protection against software attacks generated in Rich Operating System (Rich OS) such as Linux running on x86. The AMD-TEE Trusted OS running on AMD Secure Processor allows loading and execution of security sensitive applications called Trusted Applications (TAs). An example of a TA would be a DRM (Digital Rights Management) TA written to enforce content protection.
Linux already provides a tee subsystem, which is described in [1]. The tee subsystem provides a generic TEE ioctl interface which can be used by user space to talk to a TEE driver. AMD-TEE driver registers with tee subsystem and implements tee function callbacks in an AMD platform specific manner.
The following TEE commands are recognized by AMD-TEE Trusted OS:
1. TEE_CMD_ID_LOAD_TA : Load Trusted Application (TA) binary into TEE environment
2. TEE_CMD_ID_UNLOAD_TA : Unload TA binary from TEE environment
3. TEE_CMD_ID_OPEN_SESSION : Open session with loaded TA
4. TEE_CMD_ID_CLOSE_SESSION : Close session with loaded TA
5. TEE_CMD_ID_INVOKE_CMD : Invoke a command with loaded TA
6. TEE_CMD_ID_MAP_SHARED_MEM : Map shared memory
7. TEE_CMD_ID_UNMAP_SHARED_MEM : Unmap shared memory
Each command has its own payload format. The AMD-TEE driver creates a command buffer payload for submission to AMD-TEE Trusted OS.
I shall update [1] with AMD-TEE driver details shortly.
This patch series has a dependency on another patch set titled - Add TEE interface support to AMD Secure Processor driver.
Link:
https://patchwork.kernel.org/project/linux-crypto/list/?submitter=188843
v2:
* Added a helper API in AMD Secure Processor driver, which can be called by AMD-TEE driver during module init to check if TEE is present on the device
* Added proper checks for parameter attribute variable
* Used tee_shm_pool_alloc() to allocate struct tee_shm_pool data structure
* Removed all references to tee_private.h header file in driver code, except for the file drivers/tee/amdtee/core.c. The driver loads TA binary by calling request_firmware(), which takes struct device* as one of its arguments. The device 'dev' field is part of struct tee_device, defined in tee_private.h
[1] https://www.kernel.org/doc/Documentation/tee.txt
Rijo Thomas (3):
tee: allow compilation of tee subsystem for AMD CPUs
tee: add AMD-TEE driver
tee: amdtee: check TEE status during driver initialization
drivers/crypto/ccp/tee-dev.c | 11 + drivers/tee/Kconfig | 4 +- drivers/tee/Makefile | 1 + drivers/tee/amdtee/Kconfig | 8 + drivers/tee/amdtee/Makefile | 5 + drivers/tee/amdtee/amdtee_if.h | 183 +++++++++++++ drivers/tee/amdtee/amdtee_private.h | 159 +++++++++++ drivers/tee/amdtee/call.c | 373 ++++++++++++++++++++++++++ drivers/tee/amdtee/core.c | 516 ++++++++++++++++++++++++++++++++++++ drivers/tee/amdtee/shm_pool.c | 93 +++++++ include/linux/psp-tee.h | 18 ++ include/uapi/linux/tee.h | 1 + 12 files changed, 1370 insertions(+), 2 deletions(-) create mode 100644 drivers/tee/amdtee/Kconfig create mode 100644 drivers/tee/amdtee/Makefile create mode 100644 drivers/tee/amdtee/amdtee_if.h create mode 100644 drivers/tee/amdtee/amdtee_private.h create mode 100644 drivers/tee/amdtee/call.c create mode 100644 drivers/tee/amdtee/core.c create mode 100644 drivers/tee/amdtee/shm_pool.c
--
1.9.1
RFC PATCH v2 1/3 tee: allow compilation of tee subsystem for AMD CPUs
Allow compilation of tee subsystem for AMD's CPUs which have a dedicated AMD Secure Processor for Trusted Execution Environment (TEE).
--- drivers/tee/Kconfig | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-)
drivers/tee/Kconfig +1 -1
@@ -2,7 +2,7 @@ # Generic Trusted Execution Environment Configuration config TEE tristate "Trusted Execution Environment support" - depends on HAVE_ARM_SMCCC || COMPILE_TEST + depends on HAVE_ARM_SMCCC || COMPILE_TEST || CPU_SUP_AMD select DMA_SHARED_BUFFER select GENERIC_ALLOCATOR help
Signature · 1 line
1.9.1
RFC PATCH v2 2/3 tee: add AMD-TEE driver
In reply to Rijo ThomasAdds AMD-TEE driver.
* targets AMD APUs which has AMD Secure Processor with software-based Trusted Execution Environment (TEE) support
* registers with TEE subsystem
* defines tee_driver_ops function callbacks
* kernel allocated memory is used as shared memory between normal world and secure world.
* acts as REE (Rich Execution Environment) communication agent, which uses the services of AMD Secure Processor driver to submit commands for processing in TEE environment
--- drivers/tee/Kconfig | 2 +- drivers/tee/Makefile | 1 + drivers/tee/amdtee/Kconfig | 8 + drivers/tee/amdtee/Makefile | 5 + drivers/tee/amdtee/amdtee_if.h | 183 +++++++++++++ drivers/tee/amdtee/amdtee_private.h | 159 +++++++++++ drivers/tee/amdtee/call.c | 373 ++++++++++++++++++++++++++ drivers/tee/amdtee/core.c | 510 ++++++++++++++++++++++++++++++++++++ drivers/tee/amdtee/shm_pool.c | 93 +++++++ include/uapi/linux/tee.h | 1 + 10 files changed, 1334 insertions(+), 1 deletion(-) create mode 100644 drivers/tee/amdtee/Kconfig create mode 100644 drivers/tee/amdtee/Makefile create mode 100644 drivers/tee/amdtee/amdtee_if.h create mode 100644 drivers/tee/amdtee/amdtee_private.h create mode 100644 drivers/tee/amdtee/call.c create mode 100644 drivers/tee/amdtee/core.c create mode 100644 drivers/tee/amdtee/shm_pool.c
drivers/tee/Kconfig +1 -1
@@ -14,7 +14,7 @@ if TEE menu "TEE drivers" source "drivers/tee/optee/Kconfig" - +source "drivers/tee/amdtee/Kconfig" endmenu endif
drivers/tee/Makefile +1 -0
@@ -4,3 +4,4 @@ tee-objs += tee_core.o tee-objs += tee_shm.o tee-objs += tee_shm_pool.o obj-$(CONFIG_OPTEE) += optee/ +obj-$(CONFIG_AMDTEE) += amdtee/
drivers/tee/amdtee/Kconfig new file +8 -0
@@ -0,0 +1,8 @@ +# SPDX-License-Identifier: MIT +# AMD-TEE Trusted Execution Environment Configuration +config AMDTEE + tristate "AMD-TEE" + default m + depends on CRYPTO_DEV_SP_PSP + help + This implements AMD's Trusted Execution Environment (TEE) driver.
drivers/tee/amdtee/Makefile new file +5 -0
@@ -0,0 +1,5 @@ +# SPDX-License-Identifier: MIT +obj-$(CONFIG_AMDTEE) += amdtee.o +amdtee-objs += core.o +amdtee-objs += call.o +amdtee-objs += shm_pool.o
drivers/tee/amdtee/amdtee_if.h new file +183 -0
183 lines not on this page · raw message
drivers/tee/amdtee/amdtee_private.h new file +159 -0
159 lines not on this page · raw message
drivers/tee/amdtee/call.c new file +373 -0
373 lines not on this page · raw message
drivers/tee/amdtee/core.c new file +510 -0
510 lines not on this page · raw message
drivers/tee/amdtee/shm_pool.c new file +93 -0
93 lines not on this page · raw message
include/uapi/linux/tee.h +1 -0
@@ -56,6 +56,7 @@* TEE Implementation ID */ #define TEE_IMPL_ID_OPTEE 1 +#define TEE_IMPL_ID_AMDTEE 2/* * OP-TEE specific capabilities
Signature · 1 line
1.9.1
RFC PATCH v2 3/3 tee: amdtee: check TEE status during driver initialization
In reply to Rijo ThomasThe AMD-TEE driver should check if TEE is available before registering itself with TEE subsystem. This ensures that there is an TEE which the driver can talk to before proceeding with tee device node allocation.
--- drivers/crypto/ccp/tee-dev.c | 11 +++++++++++ drivers/tee/amdtee/core.c | 6 ++++++ include/linux/psp-tee.h | 18 ++++++++++++++++++ 3 files changed, 35 insertions(+)
drivers/crypto/ccp/tee-dev.c +11 -0
@@ -362,3 +362,14 @@ int psp_tee_process_cmd(enum tee_cmd_id cmd_id, void *buf, size_t len,return 0 ; }EXPORT_SYMBOL (psp_tee_process_cmd); + +int psp_check_tee_status (void ) +{ +struct psp_device *psp =psp_get_master_device (); + +if (!psp || !psp->tee_data) +return -ENODEV ; + +return 0 ; +} +EXPORT_SYMBOL (psp_check_tee_status);
drivers/tee/amdtee/core.c +6 -0
@@ -16,6 +16,7 @@#include <linux/firmware.h> #include "amdtee_private.h" #include "../tee_private.h" +#include <linux/psp-tee.h> static struct amdtee_driver_data *drv_data;static DEFINE_MUTEX (session_list_mutex);
@@ -438,6 +439,10 @@ static int __init amdtee_driver_init(void)struct tee_shm_pool *pool =ERR_PTR (-EINVAL );int rc; + rc =psp_check_tee_status (); +if (rc) + goto err_fail; + drv_data =kzalloc (sizeof (*drv_data),GFP_KERNEL );if (IS_ERR (drv_data))return -ENOMEM ;
@@ -485,6 +490,7 @@ static int __init amdtee_driver_init(void)kfree (drv_data); drv_data =NULL ; +err_fail:pr_err ("amd-tee driver initialization failed\n" );return rc; }
include/linux/psp-tee.h +18 -0
@@ -62,6 +62,19 @@ enum tee_cmd_id {int psp_tee_process_cmd (enum tee_cmd_id cmd_id,void *buf,size_t len,u32 *status); +/** +* psp_check_tee_status() - Checks whether there is a TEE which a driver can +* talk to. +* +* This function can be used by AMD-TEE driver to query if there is TEE with +* which it can communicate. +* +* Returns: +* 0 if the device has TEE +* -%ENODEV if there is no TEE available +*/ +int psp_check_tee_status (void ); +#else /* !CONFIG_CRYPTO_DEV_SP_PSP */ static inline int psp_tee_process_cmd(enum tee_cmd_id cmd_id, void *buf,
@@ -69,5 +82,10 @@ static inline int psp_tee_process_cmd(enum tee_cmd_id cmd_id, void *buf, {return -ENODEV ; } + +static inline int psp_check_tee_status (void ) +{ +return -ENODEV ; +}#endif /* CONFIG_CRYPTO_DEV_SP_PSP */ #endif /* __PSP_TEE_H_ */
Signature · 1 line
1.9.1