打通CA‑TA交互链路 | 瑞萨OP-TEE系列(6):CA开发流程
CA(Client Application)运行在Linux用户态,使用GlobalPlatform TEE Client API与TA通信。开发CA时,需要:
包含头文件:在应用中#include;并引入TA的UUID所在的头或直接在代码中定义UUID。
链接库:链接libteec.so(TEE Client库)和标准C库。编译时需指定TEEC_EXPORT环境变量,指向之前编译的optee_client/out/export/usr目录以获取库和头文件。
调用流程:CA典型的调用流程为
调用TEEC_InitializeContext(NULL, &ctx)创建TEE上下文。
调用TEEC_OpenSession(&ctx,&sess,&uuid, TEEC_LOGIN_PUBLIC, NULL,NULL, &err_origin) 与TA建立会话(使用TA的UUID)。
设置TEEC_Operation op = {0},配置 op.paramTypes和op.params(数值或内存引用参数)。
调用TEEC_InvokeCommand(&sess, command_id, &op, &err_origin)执行TA命令。可以重复多次InvokeCommand实现多次调用。
会话用完后,调用TEEC_CloseSession(&sess)关闭会话,并最终调用TEEC_FinalizeContext(&ctx)释放资源。
本篇文章将全面介绍OP-TEE的TA/CA开发模型,包括:
GlobalPlatform定义的接口体系;
PTA与UTA的区别与使用场景;
TA与CA的开发流程与通信机制;
Hello World、Secure Storage与OTP PTA实战示例;
在RZ/G2L平台上的编译、部署与调试方法;
开发中常见问题与经验总结。
6.1 CA文件结构
这里以optee_example中hello_world为例:
左右滑动查看完整内容
hello_world/host/
├── Makefile
└── main.c
6.2 调用流程
CA典型的调用流程为
调用TEEC_InitializeContext(NULL, &ctx) 创建TEE上下文。
调用TEEC_OpenSession(&ctx, &sess, &uuid, TEEC_LOGIN_PUBLIC, NULL, NULL, &err_origin) 与TA建立会话(使用TA的UUID)。
设置TEEC_Operation op = {0},配置 op.paramTypes 和 op.params(数值或内存引用参数)。
调用TEEC_InvokeCommand(&sess, command_id, &op, &err_origin) 执行TA命令。可以重复多次InvokeCommand实现多次调用。
会话用完后,调用TEEC_CloseSession(&sess) 关闭会话,并最终调用TEEC_FinalizeContext(&ctx) 释放资源。
6.3 参数传递示例
左右滑动查看完整内容
TEEC_Operationop = {0};op.paramTypes = TEEC_PARAM_TYPES(TEEC_VALUE_INOUT, TEEC_NONE, TEEC_NONE, TEEC_NONE);op.params[0].value.a =42;
执行命令后,TA会将结果写回op.params[0].value.a。
6.4 GNU Make构建
使用poky交叉工具链:
左右滑动查看完整内容
source/opt/poky/3.1.33/environment-setup-aarch64-poky-linuxmake-j$(nproc) \TEEC_EXPORT=/home/aaron/workspace/rzg/optee/optee_client/out/export/usr \--no-builtin-variables
CA也可以支持Linaro编译器编译:
左右滑动查看完整内容
exportPATH=/opt/linaro/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu/bin/:$PATHmake-j$(nproc)\CROSS_COMPILE=aarch64-linux-gnu-\TEEC_EXPORT=/out/export/usr\--no-builtin-variables
编译结果为optee_example_hello_world可执行文件。
07 RZ/G2L平台的实战演示
7.1 从零开始构建自己的Trusted Application工程
这里参考optee_examples中的helloworld例程,构建自己的源码工程,熟悉Trusted Application的流程。
创建TA_Application工程目录。
左右滑动查看完整内容
mkdirTA_ApplicationcdTA_Application
创建UTA源码路径ta并添加ta的程序代码。
左右滑动查看完整内容
mkdirtacdta
添加my_ta.c和include/my_ta.h。
这里的my_ta.h的头文件很简单,主要包含MY_TA的UUID。
左右滑动查看完整内容
#ifndefMYTEST_TA_H#defineMYTEST_TA_H
#defineTA_MY_TEST_UUID { 0xf1f20fe7, 0xead1, 0x4314, \ {0x9f, 0x4a, 0xf5, 0x63, 0x50, 0x52, 0xb9, 0xf9} }
#defineMYTEST_CMD_ADD 0#defineMYTEST_CMD_SUB 1
#endif/* MYTEST_TA_H */
该UUID其实是个随机数,它是该TA区别于其他TA的身份识别码。在linux下可以由UUIDGEN工具产生。
这里的my_ta.c也很简单,但无论是多复杂的TA,基本上都要围绕前文4.2章节提到的几个入口函数进行填充。
左右滑动查看完整内容
TEE_ResultTA_CreateEntryPoint(void)voidTA_DestroyEntryPoint(void)TEE_ResultTA_OpenSessionEntryPoint(uint32_tparam_types, TEE_Param __maybe_unused params[4], void__maybe_unused **sess_ctx)voidTA_CloseSessionEntryPoint(void__maybe_unused *sess_ctx)TEE_ResultTA_InvokeCommandEntryPoint(void__maybe_unused *sess_ctx, uint32_tcmd_id, uint32_tparam_types, TEE_Param params[4])
这几个入口函数是必须声明的,如果没有具体的功能,可以是空函数,但不可以不声明。我们这里的my_ta.c完全参考了optee_example的helloworld。
添加sub.mk并加入以下内容:
左右滑动查看完整内容
global-incdirs-y +=includesrcs-y += my_ta.c
添加Makefile并加入以下内容:
左右滑动查看完整内容
CFG_TEE_TA_LOG_LEVEL ?= 4
# The UUID for the Trusted ApplicationBINARY= f1f20fe7-ead1-4314-9f4a-f5635052b9f9
-include$(TA_DEV_KIT_DIR)/mk/ta_dev_kit.mk
ifeq($(wildcard$(TA_DEV_KIT_DIR)/mk/ta_dev_kit.mk), )clean: @echo 'Note: $$(TA_DEV_KIT_DIR)/mk/ta_dev_kit.mk not found, cannot clean TA' @echo 'Note: TA_DEV_KIT_DIR=$(TA_DEV_KIT_DIR)'endif
这个Makefile基本是固定格式,每个ta最大的区别是红色字体部分,通过uuid来命名生成的固件,这是通用的做法,当然你也可以有自己的意愿。
最后添加user_ta_header_defines.h,内容如下:
左右滑动查看完整内容
#ifndefUSER_TA_HEADER_DEFINES_H#defineUSER_TA_HEADER_DEFINES_H
/* To get the TA UUID definition */#include
#defineTA_UUID TA_MY_TA_UUID
/** TA properties: multi-instance TA, no specific attribute* TA_FLAG_EXEC_DDR is meaningless but mandated.*/#defineTA_FLAGS TA_FLAG_EXEC_DDR
/* Provisioned stack size */#defineTA_STACK_SIZE (2 * 1024)
/* Provisioned heap size for TEE_Malloc() and friends */#defineTA_DATA_SIZE (32 * 1024)
#endif/* USER_TA_HEADER_DEFINES_H */
这个基本也是固定格式,主要关联一下UUID和定义TA的堆栈信息等。
至此,一个简单的ta代码工程就完成了。
创建CA源码路径host并添加CA的程序代码。
左右滑动查看完整内容
cd TA_Applicationmkdir hostcd host添加my_ca.c,在my_ca.c中添加以下内容:#include#include#include
intmain(void){ TEEC_Result res; TEEC_Context ctx; TEEC_Session sess; TEEC_Operation op = {0}; TEEC_UUID uuid = TA_MY_TA_UUID;
res =TEEC_InitializeContext(NULL, &ctx); if(res != TEEC_SUCCESS) gotocleanup;
res =TEEC_OpenSession(&ctx, &sess, &uuid, TEEC_LOGIN_PUBLIC,NULL,NULL,NULL); if(res != TEEC_SUCCESS) gotocleanup;
// 准备加法运算: 15 + 25 op.paramTypes =TEEC_PARAM_TYPES( TEEC_VALUE_INPUT, TEEC_VALUE_INPUT, TEEC_VALUE_OUTPUT, TEEC_NONE); op.params[0].value.a =15; op.params[1].value.a =25;
res =TEEC_InvokeCommand(&sess, MYTEST_CMD_ADD, &op,NULL); if(res == TEEC_SUCCESS) printf("ADD Result: %d\n", op.params[2].value.a);
// 准备减法运算: 100 - 40 op.params[0].value.a =100; op.params[1].value.a =40;
res =TEEC_InvokeCommand(&sess, MYTEST_CMD_SUB, &op,NULL); if(res == TEEC_SUCCESS) printf("SUB Result: %d\n", op.params[2].value.a);
cleanup: TEEC_CloseSession(&sess); TEEC_FinalizeContext(&ctx); returnres;}
这个部分参考的optee_example的helloworld,功能很简单,实际上基本所有CA的调用流程都是围绕上面6.2章节提到的这几个关键函数:
左右滑动查看完整内容
TEEC_InitializeContext(NULL, &ctx);TEEC_OpenSession(&ctx, &sess, &uuid, TEEC_LOGIN_PUBLIC,NULL,NULL,NULL);TEEC_InvokeCommand(&sess, MYTEST_CMD_ADD, &op,NULL);TEEC_CloseSession(&sess);TEEC_FinalizeContext(&ctx);
至此CA的代码添加完毕。
创建CA代码的编译Makefile
左右滑动查看完整内容
CC ?=$(CROSS_COMPILE)gccLD ?=$(CROSS_COMPILE)ldAR ?=$(CROSS_COMPILE)arNM ?=$(CROSS_COMPILE)nmOBJCOPY ?=$(CROSS_COMPILE)objcopyOBJDUMP ?=$(CROSS_COMPILE)objdumpREADELF ?=$(CROSS_COMPILE)readelf
OBJS = my_ca.o
CFLAGS += -Wall -I../ta/include-I$(TEEC_EXPORT)/include-I./include#Add/link other required libraries hereLDADD += -lteec -L$(TEEC_EXPORT)/lib
BINARY = my_ca
.PHONY: allall:$(BINARY)
$(BINARY):$(OBJS) $(CC)$(LDFLAGS)-o$@$< $(LDADD)
.PHONY: cleanclean: rm -f$(OBJS)$(BINARY)
%.o: %.c $(CC)$(CFLAGS)-c$< -o $@
整个TA_Application的源码工程如下:
左右滑动查看完整内容

长按可保存查看大图
如果希望在TA_Application工程的路径下直接编译CA和TA这两部分的代码,可以添加TA_Appilication的Makefile,它的内容如下:
左右滑动查看完整内容
exportV?=0
# If _HOST or _TA specific compilers are not specified, then use CROSS_COMPILEHOST_CROSS_COMPILE ?=$(CROSS_COMPILE)TA_CROSS_COMPILE ?=$(CROSS_COMPILE)
.PHONY: allall: $(MAKE)-C host CROSS_COMPILE="$(HOST_CROSS_COMPILE)"--no-builtin-variables $(MAKE)-C ta CROSS_COMPILE="$(TA_CROSS_COMPILE)"LDFLAGS=""
.PHONY: cleanclean: $(MAKE)-C host clean $(MAKE)-C ta clean
但它不是必须的。
7.2 Trusted Application工程编译及调试运行
TA的编译:
左右滑动查看完整内容
cdTA_Application/taexportPATH=/opt/linaro/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu/bin/:$PATHmake clean TA_DEV_KIT_DIR=/home/aaron/workspace/rzg/optee/rzg_optee-os/out/arm-plat-rz/export-ta_arm64/ CFLAGS64="--sysroot=${SDKTARGETSYSROOT}"
左右滑动查看完整内容
长按可保存查看大图
CA的编译:
左右滑动查看完整内容
cdTA_Application/hostexportPATH=/opt/linaro/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu/bin/:$PATHmake TEEC_EXPORT=/home/aaron/workspace/rzg/optee/optee_client/out/export/usr --no-builtin-variables
左右滑动查看完整内容

长按可保存查看大图
调试运行:
左右滑动查看完整内容
长按可保存查看大图
拷贝TA_Application/ta中的f1f20fe7-ead1-4314-9f4a-f5635052b9f9.ta到开发板的/usr/lib/optee_armtz/路径下;
拷贝TA_Application/host中的my_ca到开发板的/home/root路径下;
运行过程如下:
左右滑动查看完整内容

长按可保存查看大图
7.3 PTA对应的CA程序开发
前文第三章中解释了PTA和UTA的开发是有区别的,但PTA对应的CA程序开发其实并没有区别,前文已描述了OTP例程的PTA源码的开发,现在以OTP例程为例展示它的CA程序的开发。
创建otp的CA源码工程路径:
左右滑动查看完整内容
mkdirotpmkdirhost
添加otp CA的源码otp.c
这个otp.c和7.1章节介绍的my_ca.c结构是类似的,它们调用的相同的头文件#include,都围绕一样的入口函数进行填充,只是在具体API的选择这块有细微的差别。otp.c围绕以下这几个API进行填充:
左右滑动查看完整内容
TEEC_InitializeContext(NULL, &sc->ctx);TEEC_OpenSession(&sc->ctx, &sc->sess, &uuid, TEEC_LOGIN_PUBLIC, NULL, NULL, NULL);TEEC_InvokeCommand(&sc->sess, PTA_OTP_CMD_READ , &op_read, &origin); TEEC_CloseSession(&sc->sess); TEEC_FinalizeContext(&sc->ctx);
添加该CA源码编译的Makefile:
左右滑动查看完整内容
CC ?=$(CROSS_COMPILE)gccLD ?=$(CROSS_COMPILE)ldAR ?=$(CROSS_COMPILE)arNM ?=$(CROSS_COMPILE)nmOBJCOPY ?=$(CROSS_COMPILE)objcopyOBJDUMP ?=$(CROSS_COMPILE)objdumpREADELF ?=$(CROSS_COMPILE)readelf
OBJS = otp.o
CFLAGS += -Wall -I../ta/include-I$(TEEC_EXPORT)/include-I./include#Add/link other required libraries hereLDADD += -lteec -L$(TEEC_EXPORT)/lib
BINARY = rzg_otp
.PHONY: allall:$(BINARY)
$(BINARY):$(OBJS) $(CC)$(LDFLAGS)-o$@$< $(LDADD)
.PHONY: cleanclean: rm -f$(OBJS)$(BINARY)
%.o: %.c $(CC)$(CFLAGS)-c$< -o $@
实际上这个Makefile和7.1章节MY_CA中的基本没有差别。
添加ta的头文件。
虽然otp的TA部分是以PTA的形式嵌入在OP-TEE OS的源码工程中,但该TA的头文件还是要拷贝出来供CA程序调用的,这里为了保持和User TA对应的CA工程一致创建了相同的存放路径。
左右滑动查看完整内容
cdotpmkdirtamkdirta/include
拷贝pta_otp.h到ta/include中。
完整代码如下:
左右滑动查看完整内容

长按可保存查看大图
这里otp下的Makefile和7.2章节中的TA_Application下的是一模一样的。二者功能一致。
CA的编译:
左右滑动查看完整内容
cdotp/hostexportPATH=/opt/linaro/gcc-linaro-7.5.0-2019.12-x86_64_aarch64-linux-gnu/bin/:$PATHmakeTEEC_EXPORT=/home/aaron/workspace/rzg/vlp3.0.7/build/tmp/work/smarc_rzg2l-poky-linux/optee-client/3.19.0+gitAUTOINC+140bf46304-r0/git/out/export/usr/ --no-builtin-variables
左右滑动查看完整内容

长按可保存查看大图
运行调试:
左右滑动查看完整内容

长按可保存查看大图
由于PTA部分已经嵌入OP-TEE OS中,只需拷贝otp/host中的rzg_otp到开发板的/home/root路径下就可以直接运行了。
运行过程如下:
左右滑动查看完整内容

长按可保存查看大图
08 开发经验与常见问题
8.1UUID不匹配
若CA与TA UUID不一致,TEEC_OpenSession会返回TEE_ERROR_ITEM_NOT_FOUND。
8.2参数类型错误
未正确使用TEE_PARAM_TYPES()定义,TA将返回TEE_ERROR_BAD_PARAMETERS。
8.3tee-supplicant未启动
若守护进程未运行,CA会报错TEEC_ERROR_COMMUNICATION。
8.4路径错误
.ta文件必须位于/lib/optee_armtz/,否则加载失败。
8.5交叉编译问题
RZ/G2L平台需使用aarch64-poky-linux-或aarch64-linux-gnu-工具链。
09 总结
本文系统介绍了OP-TEE的TA与CA开发机制,包括:
GlobalPlatform的TEE Client/Internal API模型;
PTA与UTA的区别;
TA与CA的开发流程;
从零开始Trusted Application开发以及PTA对应的CA开发实战;
在RZ/G2L平台下的编译、部署与调试。
通过本文的学习,你即可在RZ/G2L平台上完成从TA和CA编写到部署调试的完整过程,为后续安全功能的扩展(如密钥管理、RPMB安全存储等)打下坚实基础。
