打通CA‑TA交互链路 | 瑞萨OP-TEE系列(6):CA开发流程

2026.11.21 | 焜财商富 | 32066次围观

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的源码工程如下:

左右滑动查看完整内容

b85e5e38-e4a7-11f1-80b8-92fbcf53809c.png

长按可保存查看大图

如果希望在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

左右滑动查看完整内容

b87431cc-e4a7-11f1-80b8-92fbcf53809c.png

长按可保存查看大图

调试运行:

左右滑动查看完整内容

长按可保存查看大图

拷贝TA_Application/ta中的f1f20fe7-ead1-4314-9f4a-f5635052b9f9.ta到开发板的/usr/lib/optee_armtz/路径下;

拷贝TA_Application/host中的my_ca到开发板的/home/root路径下;

运行过程如下:

左右滑动查看完整内容

b88bd6e2-e4a7-11f1-80b8-92fbcf53809c.png

长按可保存查看大图

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中。

完整代码如下:

左右滑动查看完整内容

b8a69414-e4a7-11f1-80b8-92fbcf53809c.png

长按可保存查看大图

这里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

左右滑动查看完整内容

b8b3c33c-e4a7-11f1-80b8-92fbcf53809c.png

长按可保存查看大图

运行调试:

左右滑动查看完整内容

b8c614a6-e4a7-11f1-80b8-92fbcf53809c.png

长按可保存查看大图

由于PTA部分已经嵌入OP-TEE OS中,只需拷贝otp/host中的rzg_otp到开发板的/home/root路径下就可以直接运行了。

运行过程如下:

左右滑动查看完整内容

b8d0b9a6-e4a7-11f1-80b8-92fbcf53809c.png

长按可保存查看大图

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安全存储等)打下坚实基础。