[1] | 1 | /******************************************************************************
|
---|
| 2 | * @file tz_context.h
|
---|
| 3 | * @brief Context Management for Armv8-M TrustZone
|
---|
| 4 | * @version V1.0.1
|
---|
| 5 | * @date 10. January 2018
|
---|
| 6 | ******************************************************************************/
|
---|
| 7 | /*
|
---|
| 8 | * Copyright (c) 2017-2018 Arm Limited. All rights reserved.
|
---|
| 9 | *
|
---|
| 10 | * SPDX-License-Identifier: Apache-2.0
|
---|
| 11 | *
|
---|
| 12 | * Licensed under the Apache License, Version 2.0 (the License); you may
|
---|
| 13 | * not use this file except in compliance with the License.
|
---|
| 14 | * You may obtain a copy of the License at
|
---|
| 15 | *
|
---|
| 16 | * www.apache.org/licenses/LICENSE-2.0
|
---|
| 17 | *
|
---|
| 18 | * Unless required by applicable law or agreed to in writing, software
|
---|
| 19 | * distributed under the License is distributed on an AS IS BASIS, WITHOUT
|
---|
| 20 | * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
---|
| 21 | * See the License for the specific language governing permissions and
|
---|
| 22 | * limitations under the License.
|
---|
| 23 | */
|
---|
| 24 |
|
---|
| 25 | #if defined ( __ICCARM__ )
|
---|
| 26 | #pragma system_include /* treat file as system include file for MISRA check */
|
---|
| 27 | #elif defined (__clang__)
|
---|
| 28 | #pragma clang system_header /* treat file as system include file */
|
---|
| 29 | #endif
|
---|
| 30 |
|
---|
| 31 | #ifndef TZ_CONTEXT_H
|
---|
| 32 | #define TZ_CONTEXT_H
|
---|
| 33 |
|
---|
| 34 | #include <stdint.h>
|
---|
| 35 |
|
---|
| 36 | #ifndef TZ_MODULEID_T
|
---|
| 37 | #define TZ_MODULEID_T
|
---|
| 38 | /// \details Data type that identifies secure software modules called by a process.
|
---|
| 39 | typedef uint32_t TZ_ModuleId_t;
|
---|
| 40 | #endif
|
---|
| 41 |
|
---|
| 42 | /// \details TZ Memory ID identifies an allocated memory slot.
|
---|
| 43 | typedef uint32_t TZ_MemoryId_t;
|
---|
| 44 |
|
---|
| 45 | /// Initialize secure context memory system
|
---|
| 46 | /// \return execution status (1: success, 0: error)
|
---|
| 47 | uint32_t TZ_InitContextSystem_S (void);
|
---|
| 48 |
|
---|
| 49 | /// Allocate context memory for calling secure software modules in TrustZone
|
---|
| 50 | /// \param[in] module identifies software modules called from non-secure mode
|
---|
| 51 | /// \return value != 0 id TrustZone memory slot identifier
|
---|
| 52 | /// \return value 0 no memory available or internal error
|
---|
| 53 | TZ_MemoryId_t TZ_AllocModuleContext_S (TZ_ModuleId_t module);
|
---|
| 54 |
|
---|
| 55 | /// Free context memory that was previously allocated with \ref TZ_AllocModuleContext_S
|
---|
| 56 | /// \param[in] id TrustZone memory slot identifier
|
---|
| 57 | /// \return execution status (1: success, 0: error)
|
---|
| 58 | uint32_t TZ_FreeModuleContext_S (TZ_MemoryId_t id);
|
---|
| 59 |
|
---|
| 60 | /// Load secure context (called on RTOS thread context switch)
|
---|
| 61 | /// \param[in] id TrustZone memory slot identifier
|
---|
| 62 | /// \return execution status (1: success, 0: error)
|
---|
| 63 | uint32_t TZ_LoadContext_S (TZ_MemoryId_t id);
|
---|
| 64 |
|
---|
| 65 | /// Store secure context (called on RTOS thread context switch)
|
---|
| 66 | /// \param[in] id TrustZone memory slot identifier
|
---|
| 67 | /// \return execution status (1: success, 0: error)
|
---|
| 68 | uint32_t TZ_StoreContext_S (TZ_MemoryId_t id);
|
---|
| 69 |
|
---|
| 70 | #endif // TZ_CONTEXT_H
|
---|