文档管理中心
API参考设备安全能力TA快速开发系统接口

系统接口

Overview

iTrustee系统层接口函数,包括TA运行框架、通信框架、内存管理等基础接口函数。

Method Summary

展开

Qualifier and Type

Method Name and Description

TEE_Result

TA_CreateEntryPoint(void)

TA实例的构造函数,每个TA实例的生命周期中只被调用一次。如果函数执行失败,则表示创建TA实例失败。

TEE_Result

TA_OpenSessionEntryPoint(uint32_t paramTypes, TEE_Param params[4], void** sessionContext)

在CA请求创建一个与TA的会话时,TEE系统会调用此函数来创建一个会话。

TEE_Result

TA_InvokeCommandEntryPoint(void* session_context, uint32_t cmd_id, uint32_t paramTypes, TEE_Param params[4])

在CA发送指令给TA时,需要指定之前创建成功的会话,TEE系统收到请求后会调用此函数。

void

TA_CloseSessionEntryPoint(void* session_context)

在CA发起关闭与TA的会话连接时,TEE系统会调用此函数。TA需要释放用于此会话的资源。

void

TA_DestroyEntryPoint(void)

TA实例的析构函数,TEE系统在销毁TA实例时调用此函数。通常在所有会话都关闭后TEE系统会调用此函数销毁TA实例。

TEE_Result

TEE_OpenTASession(const TEE_UUID *destination, uint32_t cancellationRequestTimeout, uint32_t paramTypes, TEE_Param params[4], TEE_TASessionHandle *session, uint32_t *returnOrigin)

打开与其他TA的通信链接。

TEE_Result

TEE_InvokeTACommand(TEE_TASessionHandle session, uint32_t cancellationRequestTimeout, uint32_t commandID, uint32_t paramTypes, TEE_Param params[4], uint32_t *returnOrigin)

向目标TA发送消息。

TEE_Result

TEE_CloseTASession(TEE_TASessionHandle session)

关闭与目标TA的通信链接。

Methods

TA_CreateEntryPoint

展开

Method

TEE_Result TA_CreateEntryPoint(void)

TA实例的构造函数,每个TA实例的生命周期中只被调用一次。如果函数执行失败,则表示创建TA实例失败。

Return

展开

Type

Description

TEE_Result

参见错误码定义。

TA_OpenSessionEntryPoint

展开

Method

TEE_Result TA_OpenSessionEntryPoint(uint32_t paramTypes, TEE_Param params[4], void** sessionContext)

在CA请求创建一个与TA的会话时,TEE系统会调用此函数来创建一个会话。

Parameters

展开

Name

Description

paramTypes

TEE_Param参数类型。

params

TEE_Param实际参数。

sessionContext

指向会话的二级指针。

Return

展开

Type

Description

TEE_Result

参见错误码定义。

TA_InvokeCommandEntryPoint

展开

Method

TEE_Result TA_InvokeCommandEntryPoint(void* session_context, uint32_t cmd_id, uint32_t paramTypes, TEE_Param params[4])

在CA发送指令给TA时,需要指定之前创建成功的会话,TEE系统收到请求后会调用此函数。

Parameters

展开

Name

Description

session_context

指向会话的指针。

cmd_id

由TA自己定义的指令ID。

paramTypes

参数属性值。

params

指向参数数组的指针。

Return

展开

Type

Description

TEE_Result

参见错误码定义。

TA_CloseSessionEntryPoint

展开

Method

void TA_CloseSessionEntryPoint(void* session_context)

在CA发起关闭与TA的会话连接时,TEE系统会调用此函数。TA需要释放用于此会话的资源。

Parameters

展开

Name

Description

session_context

指向会话的指针。

Return

展开

Type

Description

void

-

TA_DestroyEntryPoint

展开

Method

void TA_DestroyEntryPoint(void)

TA实例的析构函数,TEE系统在销毁TA实例时调用此函数。通常在所有会话都关闭后TEE系统会调用此函数销毁TA实例。

Return

展开

Type

Description

void

-

TEE_OpenTASession

展开

Method

TEE_Result TEE_OpenTASession(const TEE_UUID *destination, uint32_t cancellationRequestTimeout, uint32_t paramTypes, TEE_Param params[4], TEE_TASessionHandle *session, uint32_t *returnOrigin)

打开与其他TA的通信链接。

Parameters

展开

Name

Description

destination

指向目标TA uuid的指针。

cancellationRequestTimeout

无用参数。

paramTypes

TEE_Param参数类型。

params

TEE_Param实际参数。

session

指向session的指针。

returnOrigin

返回值来源。

Return

展开

Type

Description

TEE_Result

参见错误码定义。

TEE_InvokeTACommand

展开

Method

TEE_Result TEE_InvokeTACommand(TEE_TASessionHandle session, uint32_t cancellationRequestTimeout, uint32_t commandID, uint32_t paramTypes, TEE_Param params[4], uint32_t *returnOrigin)

向目标TA发送消息。

Parameters

展开

Name

Description

session

所访问目标TA的session。

cancellationRequestTimeout

无用参数。

commandID

给session发送的命令ID。

paramTypes

TEE_Param参数类型。

params

TEE_Param实际参数。

returnOrigin

返回值来源。

Return

展开

Type

Description

TEE_Result

参见错误码定义。

TEE_CloseTASession

展开

Method

void TEE_CloseTASession(TEE_TASessionHandle session)

关闭与目标TA的通信链接。

Parameters

展开

Name

Description

session

所访问目标TA的session。

Return

展开

Type

Description

void

-

在 API参考 中进行搜索
请输入您想要搜索的关键词