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 enum drtm_dlme_el { 40 DLME_AT_EL1 = MODE_EL1, 41 DLME_AT_EL2 = MODE_EL2 42 }; 43 44 enum drtm_retc { 45 SUCCESS = SMC_OK, 46 NOT_SUPPORTED = SMC_UNK, 47 INVALID_PARAMETERS = -2, 48 DENIED = -3, 49 NOT_FOUND = -4, 50 INTERNAL_ERROR = -5, 51 MEM_PROTECT_INVALID = -6, 52 }; 53 54 typedef struct { 55 uint64_t tpm_features; 56 uint64_t minimum_memory_requirement; 57 uint64_t dma_prot_features; 58 uint64_t boot_pe_id; 59 uint64_t tcb_hash_features; 60 } drtm_features_t; 61 62 struct __packed drtm_dl_args_v1 { 63 uint16_t version; /* Must be 1. */ 64 uint8_t __res[2]; 65 uint32_t features; 66 uint64_t dlme_paddr; 67 uint64_t dlme_size; 68 uint64_t dlme_img_off; 69 uint64_t dlme_img_ep_off; 70 uint64_t dlme_img_size; 71 uint64_t dlme_data_off; 72 uint64_t dce_nwd_paddr; 73 uint64_t dce_nwd_size; 74 drtm_dl_dma_prot_args_v1_t dma_prot_args; 75 } __aligned(__alignof(uint16_t /* First member's type, `uint16_t version' */)); 76 77 struct __packed dlme_data_header_v1 { 78 uint16_t version; /* Must be 1. */ 79 uint16_t this_hdr_size; 80 uint8_t __res[4]; 81 uint64_t dlme_data_size; 82 uint64_t dlme_prot_regions_size; 83 uint64_t dlme_addr_map_size; 84 uint64_t dlme_tpm_log_size; 85 uint64_t dlme_tcb_hashes_table_size; 86 uint64_t dlme_impdef_region_size; 87 } __aligned(__alignof(uint16_t /* First member's type, `uint16_t version'. */)); 88 89 typedef struct dlme_data_header_v1 struct_dlme_data_header; 90 91 drtm_memory_region_descriptor_table_t *drtm_build_address_map(void); 92 uint64_t drtm_get_address_map_size(void); 93 94 /* 95 * Version-independent type. May be used to avoid excessive line of code 96 * changes when migrating to new struct versions. 97 */ 98 typedef struct drtm_dl_args_v1 struct_drtm_dl_args; 99 100 #endif /* DRTM_MAIN_H */ 101