1 /* 2 * Copyright (c) 2015-2017, ARM Limited and Contributors. All rights reserved. 3 * 4 * Redistribution and use in source and binary forms, with or without 5 * modification, are permitted provided that the following conditions are met: 6 * 7 * Redistributions of source code must retain the above copyright notice, this 8 * list of conditions and the following disclaimer. 9 * 10 * Redistributions in binary form must reproduce the above copyright notice, 11 * this list of conditions and the following disclaimer in the documentation 12 * and/or other materials provided with the distribution. 13 * 14 * Neither the name of ARM nor the names of its contributors may be used 15 * to endorse or promote products derived from this software without specific 16 * prior written permission. 17 * 18 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 19 * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 20 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 21 * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE 22 * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 23 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 24 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 25 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 26 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 27 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 28 * POSSIBILITY OF SUCH DAMAGE. 29 */ 30 #ifndef __ARM_DEF_H__ 31 #define __ARM_DEF_H__ 32 33 #include <arch.h> 34 #include <common_def.h> 35 #include <platform_def.h> 36 #include <tbbr_img_def.h> 37 #include <xlat_tables_defs.h> 38 39 40 /****************************************************************************** 41 * Definitions common to all ARM standard platforms 42 *****************************************************************************/ 43 44 /* Special value used to verify platform parameters from BL2 to BL31 */ 45 #define ARM_BL31_PLAT_PARAM_VAL 0x0f1e2d3c4b5a6978ULL 46 47 #define ARM_SYSTEM_COUNT 1 48 49 #define ARM_CACHE_WRITEBACK_SHIFT 6 50 51 /* 52 * Macros mapping the MPIDR Affinity levels to ARM Platform Power levels. The 53 * power levels have a 1:1 mapping with the MPIDR affinity levels. 54 */ 55 #define ARM_PWR_LVL0 MPIDR_AFFLVL0 56 #define ARM_PWR_LVL1 MPIDR_AFFLVL1 57 #define ARM_PWR_LVL2 MPIDR_AFFLVL2 58 59 /* 60 * Macros for local power states in ARM platforms encoded by State-ID field 61 * within the power-state parameter. 62 */ 63 /* Local power state for power domains in Run state. */ 64 #define ARM_LOCAL_STATE_RUN 0 65 /* Local power state for retention. Valid only for CPU power domains */ 66 #define ARM_LOCAL_STATE_RET 1 67 /* Local power state for OFF/power-down. Valid for CPU and cluster power 68 domains */ 69 #define ARM_LOCAL_STATE_OFF 2 70 71 /* Memory location options for TSP */ 72 #define ARM_TRUSTED_SRAM_ID 0 73 #define ARM_TRUSTED_DRAM_ID 1 74 #define ARM_DRAM_ID 2 75 76 /* The first 4KB of Trusted SRAM are used as shared memory */ 77 #define ARM_TRUSTED_SRAM_BASE 0x04000000 78 #define ARM_SHARED_RAM_BASE ARM_TRUSTED_SRAM_BASE 79 #define ARM_SHARED_RAM_SIZE 0x00001000 /* 4 KB */ 80 81 /* The remaining Trusted SRAM is used to load the BL images */ 82 #define ARM_BL_RAM_BASE (ARM_SHARED_RAM_BASE + \ 83 ARM_SHARED_RAM_SIZE) 84 #define ARM_BL_RAM_SIZE (PLAT_ARM_TRUSTED_SRAM_SIZE - \ 85 ARM_SHARED_RAM_SIZE) 86 87 /* 88 * The top 16MB of DRAM1 is configured as secure access only using the TZC 89 * - SCP TZC DRAM: If present, DRAM reserved for SCP use 90 * - AP TZC DRAM: The remaining TZC secured DRAM reserved for AP use 91 */ 92 #define ARM_TZC_DRAM1_SIZE ULL(0x01000000) 93 94 #define ARM_SCP_TZC_DRAM1_BASE (ARM_DRAM1_BASE + \ 95 ARM_DRAM1_SIZE - \ 96 ARM_SCP_TZC_DRAM1_SIZE) 97 #define ARM_SCP_TZC_DRAM1_SIZE PLAT_ARM_SCP_TZC_DRAM1_SIZE 98 #define ARM_SCP_TZC_DRAM1_END (ARM_SCP_TZC_DRAM1_BASE + \ 99 ARM_SCP_TZC_DRAM1_SIZE - 1) 100 101 #define ARM_AP_TZC_DRAM1_BASE (ARM_DRAM1_BASE + \ 102 ARM_DRAM1_SIZE - \ 103 ARM_TZC_DRAM1_SIZE) 104 #define ARM_AP_TZC_DRAM1_SIZE (ARM_TZC_DRAM1_SIZE - \ 105 ARM_SCP_TZC_DRAM1_SIZE) 106 #define ARM_AP_TZC_DRAM1_END (ARM_AP_TZC_DRAM1_BASE + \ 107 ARM_AP_TZC_DRAM1_SIZE - 1) 108 109 110 #define ARM_NS_DRAM1_BASE ARM_DRAM1_BASE 111 #define ARM_NS_DRAM1_SIZE (ARM_DRAM1_SIZE - \ 112 ARM_TZC_DRAM1_SIZE) 113 #define ARM_NS_DRAM1_END (ARM_NS_DRAM1_BASE + \ 114 ARM_NS_DRAM1_SIZE - 1) 115 116 #define ARM_DRAM1_BASE ULL(0x80000000) 117 #define ARM_DRAM1_SIZE ULL(0x80000000) 118 #define ARM_DRAM1_END (ARM_DRAM1_BASE + \ 119 ARM_DRAM1_SIZE - 1) 120 121 #define ARM_DRAM2_BASE ULL(0x880000000) 122 #define ARM_DRAM2_SIZE PLAT_ARM_DRAM2_SIZE 123 #define ARM_DRAM2_END (ARM_DRAM2_BASE + \ 124 ARM_DRAM2_SIZE - 1) 125 126 #define ARM_IRQ_SEC_PHY_TIMER 29 127 128 #define ARM_IRQ_SEC_SGI_0 8 129 #define ARM_IRQ_SEC_SGI_1 9 130 #define ARM_IRQ_SEC_SGI_2 10 131 #define ARM_IRQ_SEC_SGI_3 11 132 #define ARM_IRQ_SEC_SGI_4 12 133 #define ARM_IRQ_SEC_SGI_5 13 134 #define ARM_IRQ_SEC_SGI_6 14 135 #define ARM_IRQ_SEC_SGI_7 15 136 137 /* 138 * Define a list of Group 1 Secure and Group 0 interrupts as per GICv3 139 * terminology. On a GICv2 system or mode, the lists will be merged and treated 140 * as Group 0 interrupts. 141 */ 142 #define ARM_G1S_IRQS ARM_IRQ_SEC_PHY_TIMER, \ 143 ARM_IRQ_SEC_SGI_1, \ 144 ARM_IRQ_SEC_SGI_2, \ 145 ARM_IRQ_SEC_SGI_3, \ 146 ARM_IRQ_SEC_SGI_4, \ 147 ARM_IRQ_SEC_SGI_5, \ 148 ARM_IRQ_SEC_SGI_7 149 150 #define ARM_G0_IRQS ARM_IRQ_SEC_SGI_0, \ 151 ARM_IRQ_SEC_SGI_6 152 153 #define ARM_MAP_SHARED_RAM MAP_REGION_FLAT( \ 154 ARM_SHARED_RAM_BASE, \ 155 ARM_SHARED_RAM_SIZE, \ 156 MT_DEVICE | MT_RW | MT_SECURE) 157 158 #define ARM_MAP_NS_DRAM1 MAP_REGION_FLAT( \ 159 ARM_NS_DRAM1_BASE, \ 160 ARM_NS_DRAM1_SIZE, \ 161 MT_MEMORY | MT_RW | MT_NS) 162 163 #define ARM_MAP_TSP_SEC_MEM MAP_REGION_FLAT( \ 164 TSP_SEC_MEM_BASE, \ 165 TSP_SEC_MEM_SIZE, \ 166 MT_MEMORY | MT_RW | MT_SECURE) 167 168 #if ARM_BL31_IN_DRAM 169 #define ARM_MAP_BL31_SEC_DRAM MAP_REGION_FLAT( \ 170 BL31_BASE, \ 171 PLAT_ARM_MAX_BL31_SIZE, \ 172 MT_MEMORY | MT_RW | MT_SECURE) 173 #endif 174 175 /* 176 * The number of regions like RO(code), coherent and data required by 177 * different BL stages which need to be mapped in the MMU. 178 */ 179 #if USE_COHERENT_MEM 180 #define ARM_BL_REGIONS 3 181 #else 182 #define ARM_BL_REGIONS 2 183 #endif 184 185 #define MAX_MMAP_REGIONS (PLAT_ARM_MMAP_ENTRIES + \ 186 ARM_BL_REGIONS) 187 188 /* Memory mapped Generic timer interfaces */ 189 #define ARM_SYS_CNTCTL_BASE 0x2a430000 190 #define ARM_SYS_CNTREAD_BASE 0x2a800000 191 #define ARM_SYS_TIMCTL_BASE 0x2a810000 192 193 #define ARM_CONSOLE_BAUDRATE 115200 194 195 /* Trusted Watchdog constants */ 196 #define ARM_SP805_TWDG_BASE 0x2a490000 197 #define ARM_SP805_TWDG_CLK_HZ 32768 198 /* The TBBR document specifies a watchdog timeout of 256 seconds. SP805 199 * asserts reset after two consecutive countdowns (2 x 128 = 256 sec) */ 200 #define ARM_TWDG_TIMEOUT_SEC 128 201 #define ARM_TWDG_LOAD_VAL (ARM_SP805_TWDG_CLK_HZ * \ 202 ARM_TWDG_TIMEOUT_SEC) 203 204 /****************************************************************************** 205 * Required platform porting definitions common to all ARM standard platforms 206 *****************************************************************************/ 207 208 #define PLAT_PHY_ADDR_SPACE_SIZE (1ull << 32) 209 #define PLAT_VIRT_ADDR_SPACE_SIZE (1ull << 32) 210 211 /* 212 * This macro defines the deepest retention state possible. A higher state 213 * id will represent an invalid or a power down state. 214 */ 215 #define PLAT_MAX_RET_STATE ARM_LOCAL_STATE_RET 216 217 /* 218 * This macro defines the deepest power down states possible. Any state ID 219 * higher than this is invalid. 220 */ 221 #define PLAT_MAX_OFF_STATE ARM_LOCAL_STATE_OFF 222 223 /* 224 * Some data must be aligned on the biggest cache line size in the platform. 225 * This is known only to the platform as it might have a combination of 226 * integrated and external caches. 227 */ 228 #define CACHE_WRITEBACK_GRANULE (1 << ARM_CACHE_WRITEBACK_SHIFT) 229 230 231 /******************************************************************************* 232 * BL1 specific defines. 233 * BL1 RW data is relocated from ROM to RAM at runtime so we need 2 sets of 234 * addresses. 235 ******************************************************************************/ 236 #define BL1_RO_BASE PLAT_ARM_TRUSTED_ROM_BASE 237 #define BL1_RO_LIMIT (PLAT_ARM_TRUSTED_ROM_BASE \ 238 + PLAT_ARM_TRUSTED_ROM_SIZE) 239 /* 240 * Put BL1 RW at the top of the Trusted SRAM. 241 */ 242 #define BL1_RW_BASE (ARM_BL_RAM_BASE + \ 243 ARM_BL_RAM_SIZE - \ 244 PLAT_ARM_MAX_BL1_RW_SIZE) 245 #define BL1_RW_LIMIT (ARM_BL_RAM_BASE + ARM_BL_RAM_SIZE) 246 247 /******************************************************************************* 248 * BL2 specific defines. 249 ******************************************************************************/ 250 #if ARM_BL31_IN_DRAM 251 /* 252 * BL31 is loaded in the DRAM. 253 * Put BL2 just below BL1. 254 */ 255 #define BL2_BASE (BL1_RW_BASE - PLAT_ARM_MAX_BL2_SIZE) 256 #define BL2_LIMIT BL1_RW_BASE 257 #else 258 /* 259 * Put BL2 just below BL31. 260 */ 261 #define BL2_BASE (BL31_BASE - PLAT_ARM_MAX_BL2_SIZE) 262 #define BL2_LIMIT BL31_BASE 263 #endif 264 265 /******************************************************************************* 266 * BL31 specific defines. 267 ******************************************************************************/ 268 #if ARM_BL31_IN_DRAM 269 /* 270 * Put BL31 at the bottom of TZC secured DRAM 271 */ 272 #define BL31_BASE ARM_AP_TZC_DRAM1_BASE 273 #define BL31_LIMIT (ARM_AP_TZC_DRAM1_BASE + \ 274 PLAT_ARM_MAX_BL31_SIZE) 275 #else 276 /* 277 * Put BL31 at the top of the Trusted SRAM. 278 */ 279 #define BL31_BASE (ARM_BL_RAM_BASE + \ 280 ARM_BL_RAM_SIZE - \ 281 PLAT_ARM_MAX_BL31_SIZE) 282 #define BL31_PROGBITS_LIMIT BL1_RW_BASE 283 #define BL31_LIMIT (ARM_BL_RAM_BASE + ARM_BL_RAM_SIZE) 284 #endif 285 286 /******************************************************************************* 287 * BL32 specific defines. 288 ******************************************************************************/ 289 /* 290 * On ARM standard platforms, the TSP can execute from Trusted SRAM, 291 * Trusted DRAM (if available) or the DRAM region secured by the TrustZone 292 * controller. 293 */ 294 #if ARM_BL31_IN_DRAM 295 # define TSP_SEC_MEM_BASE (ARM_AP_TZC_DRAM1_BASE + \ 296 PLAT_ARM_MAX_BL31_SIZE) 297 # define TSP_SEC_MEM_SIZE (ARM_AP_TZC_DRAM1_SIZE - \ 298 PLAT_ARM_MAX_BL31_SIZE) 299 # define BL32_BASE (ARM_AP_TZC_DRAM1_BASE + \ 300 PLAT_ARM_MAX_BL31_SIZE) 301 # define BL32_LIMIT (ARM_AP_TZC_DRAM1_BASE + \ 302 ARM_AP_TZC_DRAM1_SIZE) 303 #elif ARM_TSP_RAM_LOCATION_ID == ARM_TRUSTED_SRAM_ID 304 # define TSP_SEC_MEM_BASE ARM_BL_RAM_BASE 305 # define TSP_SEC_MEM_SIZE ARM_BL_RAM_SIZE 306 # define TSP_PROGBITS_LIMIT BL2_BASE 307 # define BL32_BASE ARM_BL_RAM_BASE 308 # define BL32_LIMIT BL31_BASE 309 #elif ARM_TSP_RAM_LOCATION_ID == ARM_TRUSTED_DRAM_ID 310 # define TSP_SEC_MEM_BASE PLAT_ARM_TRUSTED_DRAM_BASE 311 # define TSP_SEC_MEM_SIZE PLAT_ARM_TRUSTED_DRAM_SIZE 312 # define BL32_BASE PLAT_ARM_TRUSTED_DRAM_BASE 313 # define BL32_LIMIT (PLAT_ARM_TRUSTED_DRAM_BASE \ 314 + (1 << 21)) 315 #elif ARM_TSP_RAM_LOCATION_ID == ARM_DRAM_ID 316 # define TSP_SEC_MEM_BASE ARM_AP_TZC_DRAM1_BASE 317 # define TSP_SEC_MEM_SIZE ARM_AP_TZC_DRAM1_SIZE 318 # define BL32_BASE ARM_AP_TZC_DRAM1_BASE 319 # define BL32_LIMIT (ARM_AP_TZC_DRAM1_BASE + \ 320 ARM_AP_TZC_DRAM1_SIZE) 321 #else 322 # error "Unsupported ARM_TSP_RAM_LOCATION_ID value" 323 #endif 324 325 /* BL32 is mandatory in AArch32 */ 326 #ifndef AARCH32 327 #ifdef SPD_none 328 #undef BL32_BASE 329 #endif /* SPD_none */ 330 #endif 331 332 /******************************************************************************* 333 * FWU Images: NS_BL1U, BL2U & NS_BL2U defines. 334 ******************************************************************************/ 335 #define BL2U_BASE BL2_BASE 336 #if ARM_BL31_IN_DRAM 337 #define BL2U_LIMIT BL1_RW_BASE 338 #else 339 #define BL2U_LIMIT BL31_BASE 340 #endif 341 #define NS_BL2U_BASE ARM_NS_DRAM1_BASE 342 #define NS_BL1U_BASE (PLAT_ARM_NVM_BASE + 0x03EB8000) 343 344 /* 345 * ID of the secure physical generic timer interrupt used by the TSP. 346 */ 347 #define TSP_IRQ_SEC_PHY_TIMER ARM_IRQ_SEC_PHY_TIMER 348 349 350 /* 351 * One cache line needed for bakery locks on ARM platforms 352 */ 353 #define PLAT_PERCPU_BAKERY_LOCK_SIZE (1 * CACHE_WRITEBACK_GRANULE) 354 355 356 #endif /* __ARM_DEF_H__ */ 357