4 / 369 TEE Internal Core API Specification – Public Release v1.3
Copyright
2011-2021 GlobalPlatform, Inc. All Rights Reserved.
The technology provided or described herein is subject to updates, revisions, and extensions by GlobalPlatform. Use of this
information is governed by the GlobalPlatform license agreement and any use inconsistent with that agreement is strictly
prohibited.
3.4.5 [outbufopt] .................................................................................................................................... 48
3.4.6 [instring] and [instringopt] ............................................................................................................. 48
3.4.7 [outstring] and [outstringopt] ........................................................................................................ 48
3.4.8 [ctx] ............................................................................................................................................... 48
3.5 Backward Compatibility ....................................................................................................................... 49
3.5.1 Version Compatibility Definitions ................................................................................................. 49
4 Trusted Core Framework API ................................................................................................. 51
4.1 Data Types .......................................................................................................................................... 52
4.1.1 TEE_Identity ................................................................................................................................. 52
4.1.2 TEE_Param .................................................................................................................................. 52
4.1.3 TEE_TASessionHandle ............................................................................................................... 53
4.1.4 TEE_PropSetHandle .................................................................................................................... 53
4.2 Constants ............................................................................................................................................ 54
4.2.1 Parameter Types .......................................................................................................................... 54
4.2.2 Login Types .................................................................................................................................. 54
4.2.3 Origin Codes ................................................................................................................................ 55
4.2.4 Property Set Pseudo-Handles ..................................................................................................... 55
4.2.5 Memory Access Rights ................................................................................................................ 55
4.3 TA Interface ......................................................................................................................................... 56
4.3.1 TA_CreateEntryPoint ................................................................................................................... 59
4.3.2 TA_DestroyEntryPoint .................................................................................................................. 59
4.3.3 TA_OpenSessionEntryPoint ........................................................................................................ 60
4.3.4 TA_CloseSessionEntryPoint ........................................................................................................ 62
4.3.5 TA_InvokeCommandEntryPoint ................................................................................................... 63
4.3.6 Operation Parameters in the TA Interface ................................................................................... 64
4.4 Property Access Functions ................................................................................................................. 68
4.4.1 TEE_GetPropertyAsString ........................................................................................................... 70
4.4.2 TEE_GetPropertyAsBool ............................................................................................................. 71
4.4.3 TEE_GetPropertyAsUnn .............................................................................................................. 72
4.4.4 TEE_GetPropertyAsBinaryBlock ................................................................................................. 74
4.4.5 TEE_GetPropertyAsUUID ............................................................................................................ 75
4.4.6 TEE_GetPropertyAsIdentity ......................................................................................................... 76
4.4.7 TEE_AllocatePropertyEnumerator ............................................................................................... 77
4.4.8 TEE_FreePropertyEnumerator .................................................................................................... 77
4.4.9 TEE_StartPropertyEnumerator .................................................................................................... 78
4.4.10 TEE_ResetPropertyEnumerator .................................................................................................. 78
4.4.11 TEE_GetPropertyName ............................................................................................................... 79
4.4.12 TEE_GetNextProperty ................................................................................................................. 80
4.5 Trusted Application Configuration Properties ..................................................................................... 81
4.6 Client Properties .................................................................................................................................. 84
4.7 Implementation Properties .................................................................................................................. 86
4.7.1 Specification Version Number Property ....................................................................................... 93
4.8 Panics .................................................................................................................................................. 94
4.8.1 TEE_Panic ................................................................................................................................... 94
4.9 Internal Client API ............................................................................................................................... 95
4.9.1 TEE_OpenTASession .................................................................................................................. 95
4.9.2 TEE_CloseTASession .................................................................................................................. 97
4.9.3 TEE_InvokeTACommand ............................................................................................................ 98
4.9.4 Operation Parameters in the Internal Client API ........................................................................ 100
4.10 Cancellation Functions ...................................................................................................................... 102
4.10.1 TEE_GetCancellationFlag .......................................................................................................... 103
4.10.2 TEE_UnmaskCancellation ......................................................................................................... 104