1 /* 2 * Copyright (c) 2022 Arm Limited. All rights reserved. 3 * 4 * SPDX-License-Identifier: BSD-3-Clause 5 * 6 */ 7 #ifndef DRTM_MAIN_H 8 #define DRTM_MAIN_H 9 10 #include <stdint.h> 11 12 #include <assert.h> 13 #include <lib/smccc.h> 14 15 #include "drtm_dma_prot.h" 16 17 #define ALIGNED_UP(x, a) __extension__ ({ \ 18 __typeof__(a) _a = (a); \ 19 __typeof__(a) _one = 1; \ 20 assert(IS_POWER_OF_TWO(_a)); \ 21 ((x) + (_a - _one)) & ~(_a - _one); \ 22 }) 23 24 #define ALIGNED_DOWN(x, a) __extension__ ({ \ 25 __typeof__(a) _a = (a); \ 26 __typeof__(a) _one = 1; \ 27 assert(IS_POWER_OF_TWO(_a)); \ 28 (x) & ~(_a - _one); \ 29 }) 30 31 #define DRTM_PAGE_SIZE (4 * (1 << 10)) 32 #define DRTM_PAGE_SIZE_STR "4-KiB" 33 34 #define DL_ARGS_GET_DMA_PROT_TYPE(a) (((a)->features >> 3) & 0x7U) 35 #define DL_ARGS_GET_PCR_SCHEMA(a) (((a)->features >> 1) & 0x3U) 36 #define DL_ARGS_GET_DLME_ENTRY_POINT(a) \ 37 (((a)->dlme_paddr + (a)->dlme_img_off + (a)->dlme_img_ep_off)) 38 39 /* 40 * Range(Min/Max) of DRTM parameter structure versions supported 41 */ 42 #define ARM_DRTM_PARAMS_MIN_VERSION U(1) 43 #define ARM_DRTM_PARAMS_MAX_VERSION U(1) 44 45 enum drtm_dlme_el { 46 DLME_AT_EL1 = MODE_EL1, 47 DLME_AT_EL2 = MODE_EL2 48 }; 49 50 enum drtm_retc { 51 SUCCESS = SMC_OK, 52 NOT_SUPPORTED = SMC_UNK, 53 INVALID_PARAMETERS = -2, 54 DENIED = -3, 55 NOT_FOUND = -4, 56 INTERNAL_ERROR = -5, 57 MEM_PROTECT_INVALID = -6, 58 }; 59 60 typedef struct { 61 uint64_t tpm_features; 62 uint64_t minimum_memory_requirement; 63 uint64_t dma_prot_features; 64 uint64_t boot_pe_id; 65 uint64_t tcb_hash_features; 66 } drtm_features_t; 67 68 struct __packed drtm_dl_args_v1 { 69 uint16_t version; /* Must be 1. */ 70 uint8_t __res[2]; 71 uint32_t features; 72 uint64_t dlme_paddr; 73 uint64_t dlme_size; 74 uint64_t dlme_img_off; 75 uint64_t dlme_img_ep_off; 76 uint64_t dlme_img_size; 77 uint64_t dlme_data_off; 78 uint64_t dce_nwd_paddr; 79 uint64_t dce_nwd_size; 80 drtm_dl_dma_prot_args_v1_t dma_prot_args; 81 } __aligned(__alignof(uint16_t /* First member's type, `uint16_t version' */)); 82 83 struct __packed dlme_data_header_v1 { 84 uint16_t version; /* Must be 1. */ 85 uint16_t this_hdr_size; 86 uint8_t __res[4]; 87 uint64_t dlme_data_size; 88 uint64_t dlme_prot_regions_size; 89 uint64_t dlme_addr_map_size; 90 uint64_t dlme_tpm_log_size; 91 uint64_t dlme_tcb_hashes_table_size; 92 uint64_t dlme_impdef_region_size; 93 } __aligned(__alignof(uint16_t /* First member's type, `uint16_t version'. */)); 94 95 typedef struct dlme_data_header_v1 struct_dlme_data_header; 96 97 drtm_memory_region_descriptor_table_t *drtm_build_address_map(void); 98 uint64_t drtm_get_address_map_size(void); 99 100 /* 101 * Version-independent type. May be used to avoid excessive line of code 102 * changes when migrating to new struct versions. 103 */ 104 typedef struct drtm_dl_args_v1 struct_drtm_dl_args; 105 106 #endif /* DRTM_MAIN_H */ 107