1 /* 2 * Copyright (c) 2021-2024, Arm Limited and Contributors. All rights reserved. 3 * 4 * SPDX-License-Identifier: BSD-3-Clause 5 */ 6 7 #ifndef RMMD_SVC_H 8 #define RMMD_SVC_H 9 10 #include <lib/smccc.h> 11 #include <lib/utils_def.h> 12 13 /* STD calls FNUM Min/Max ranges */ 14 #define RMI_FNUM_MIN_VALUE U(0x150) 15 #define RMI_FNUM_MAX_VALUE U(0x18F) 16 17 /* Construct RMI fastcall std FID from offset */ 18 #define SMC64_RMI_FID(_offset) \ 19 ((SMC_TYPE_FAST << FUNCID_TYPE_SHIFT) | \ 20 (SMC_64 << FUNCID_CC_SHIFT) | \ 21 (OEN_STD_START << FUNCID_OEN_SHIFT) | \ 22 (((RMI_FNUM_MIN_VALUE + (_offset)) & FUNCID_NUM_MASK) \ 23 << FUNCID_NUM_SHIFT)) 24 25 #define is_rmi_fid(fid) __extension__ ({ \ 26 __typeof__(fid) _fid = (fid); \ 27 ((GET_SMC_NUM(_fid) >= RMI_FNUM_MIN_VALUE) && \ 28 (GET_SMC_NUM(_fid) <= RMI_FNUM_MAX_VALUE) && \ 29 (GET_SMC_TYPE(_fid) == SMC_TYPE_FAST) && \ 30 (GET_SMC_CC(_fid) == SMC_64) && \ 31 (GET_SMC_OEN(_fid) == OEN_STD_START) && \ 32 ((_fid & 0x00FE0000) == 0U)); }) 33 34 /* 35 * RMI_FNUM_REQ_COMPLETE is the only function in the RMI range that originates 36 * from the Realm world and is handled by the RMMD. The RMI functions are 37 * always invoked by the Normal world, forwarded by RMMD and handled by the 38 * RMM. 39 */ 40 /* 0x18F */ 41 #define RMM_RMI_REQ_COMPLETE SMC64_RMI_FID(U(0x3F)) 42 43 /* RMM_BOOT_COMPLETE arg0 error codes */ 44 #define E_RMM_BOOT_SUCCESS (0) 45 #define E_RMM_BOOT_UNKNOWN (-1) 46 #define E_RMM_BOOT_VERSION_MISMATCH (-2) 47 #define E_RMM_BOOT_CPUS_OUT_OF_RANGE (-3) 48 #define E_RMM_BOOT_CPU_ID_OUT_OF_RANGE (-4) 49 #define E_RMM_BOOT_INVALID_SHARED_BUFFER (-5) 50 #define E_RMM_BOOT_MANIFEST_VERSION_NOT_SUPPORTED (-6) 51 #define E_RMM_BOOT_MANIFEST_DATA_ERROR (-7) 52 53 /* The SMC in the range 0x8400 0191 - 0x8400 01AF are reserved for RSIs.*/ 54 55 /* 56 * EL3 - RMM SMCs used for requesting RMMD services. These SMCs originate in Realm 57 * world and return to Realm world. 58 * 59 * These are allocated from 0x8400 01B0 - 0x8400 01CF in the RMM Service range. 60 */ 61 #define RMMD_EL3_FNUM_MIN_VALUE U(0x1B0) 62 #define RMMD_EL3_FNUM_MAX_VALUE U(0x1CF) 63 64 /* Construct RMM_EL3 fastcall std FID from offset */ 65 #define SMC64_RMMD_EL3_FID(_offset) \ 66 ((SMC_TYPE_FAST << FUNCID_TYPE_SHIFT) | \ 67 (SMC_64 << FUNCID_CC_SHIFT) | \ 68 (OEN_STD_START << FUNCID_OEN_SHIFT) | \ 69 (((RMMD_EL3_FNUM_MIN_VALUE + (_offset)) & FUNCID_NUM_MASK) \ 70 << FUNCID_NUM_SHIFT)) 71 72 /* The macros below are used to identify GTSI calls from the SMC function ID */ 73 #define is_rmmd_el3_fid(fid) __extension__ ({ \ 74 __typeof__(fid) _fid = (fid); \ 75 ((GET_SMC_NUM(_fid) >= RMMD_EL3_FNUM_MIN_VALUE) &&\ 76 (GET_SMC_NUM(_fid) <= RMMD_EL3_FNUM_MAX_VALUE) &&\ 77 (GET_SMC_TYPE(_fid) == SMC_TYPE_FAST) && \ 78 (GET_SMC_CC(_fid) == SMC_64) && \ 79 (GET_SMC_OEN(_fid) == OEN_STD_START) && \ 80 ((_fid & 0x00FE0000) == 0U)); }) 81 82 /* 0x1B0 - 0x1B1 */ 83 #define RMM_GTSI_DELEGATE SMC64_RMMD_EL3_FID(U(0)) 84 #define RMM_GTSI_UNDELEGATE SMC64_RMMD_EL3_FID(U(1)) 85 86 /* Return error codes from RMM-EL3 SMCs */ 87 #define E_RMM_OK 0 88 #define E_RMM_UNK -1 89 #define E_RMM_BAD_ADDR -2 90 #define E_RMM_BAD_PAS -3 91 #define E_RMM_NOMEM -4 92 #define E_RMM_INVAL -5 93 #define E_RMM_AGAIN -6 94 95 /* Return error codes from RMI SMCs */ 96 #define RMI_SUCCESS 0 97 #define RMI_ERROR_INPUT 1 98 99 /* Acceptable SHA sizes for Challenge object */ 100 #define SHA256_DIGEST_SIZE 32U 101 #define SHA384_DIGEST_SIZE 48U 102 #define SHA512_DIGEST_SIZE 64U 103 104 /* 105 * Retrieve Realm attestation key from EL3. Only P-384 ECC curve key is 106 * supported. The arguments to this SMC are : 107 * arg0 - Function ID. 108 * arg1 - Realm attestation key buffer Physical address. 109 * arg2 - Realm attestation key buffer size (in bytes). 110 * arg3 - The type of the elliptic curve to which the requested 111 * attestation key belongs to. The value should be one of the 112 * defined curve types. 113 * The return arguments are : 114 * ret0 - Status / error. 115 * ret1 - Size of the realm attestation key if successful. 116 */ 117 /* 0x1B2 */ 118 #define RMM_ATTEST_GET_REALM_KEY SMC64_RMMD_EL3_FID(U(2)) 119 120 /* 121 * Retrieve Platform token from EL3. 122 * The arguments to this SMC are : 123 * arg0 - Function ID. 124 * arg1 - Platform attestation token buffer Physical address. (The challenge 125 * object is passed in this buffer.) 126 * arg2 - Platform attestation token buffer size (in bytes). 127 * arg3 - Challenge object size (in bytes). It has to be one of the defined 128 * SHA hash sizes. 129 * The return arguments are : 130 * ret0 - Status / error. 131 * ret1 - Size of the platform token if successful. 132 */ 133 /* 0x1B3 */ 134 #define RMM_ATTEST_GET_PLAT_TOKEN SMC64_RMMD_EL3_FID(U(3)) 135 136 /* ECC Curve types for attest key generation */ 137 #define ATTEST_KEY_CURVE_ECC_SECP384R1 0 138 139 /* 140 * RMM_BOOT_COMPLETE originates on RMM when the boot finishes (either cold 141 * or warm boot). This is handled by the RMM-EL3 interface SMC handler. 142 * 143 * RMM_BOOT_COMPLETE FID is located at the end of the available range. 144 */ 145 /* 0x1CF */ 146 #define RMM_BOOT_COMPLETE SMC64_RMMD_EL3_FID(U(0x1F)) 147 148 /* 149 * The major version number of the RMM Boot Interface implementation. 150 * Increase this whenever the semantics of the boot arguments change making it 151 * backwards incompatible. 152 */ 153 #define RMM_EL3_IFC_VERSION_MAJOR (U(0)) 154 155 /* 156 * The minor version number of the RMM Boot Interface implementation. 157 * Increase this when a bug is fixed, or a feature is added without 158 * breaking compatibility. 159 */ 160 #define RMM_EL3_IFC_VERSION_MINOR (U(3)) 161 162 #define RMM_EL3_INTERFACE_VERSION \ 163 (((RMM_EL3_IFC_VERSION_MAJOR << 16) & 0x7FFFF) | \ 164 RMM_EL3_IFC_VERSION_MINOR) 165 166 #define RMM_EL3_IFC_VERSION_GET_MAJOR(_version) (((_version) >> 16) \ 167 & 0x7FFF) 168 #define RMM_EL3_IFC_VERSION_GET_MAJOR_MINOR(_version) ((_version) & 0xFFFF) 169 170 #ifndef __ASSEMBLER__ 171 #include <stdint.h> 172 173 int rmmd_setup(void); 174 uint64_t rmmd_rmi_handler(uint32_t smc_fid, 175 uint64_t x1, 176 uint64_t x2, 177 uint64_t x3, 178 uint64_t x4, 179 void *cookie, 180 void *handle, 181 uint64_t flags); 182 183 uint64_t rmmd_rmm_el3_handler(uint32_t smc_fid, 184 uint64_t x1, 185 uint64_t x2, 186 uint64_t x3, 187 uint64_t x4, 188 void *cookie, 189 void *handle, 190 uint64_t flags); 191 192 #endif /* __ASSEMBLER__ */ 193 #endif /* RMMD_SVC_H */ 194