blob: a6b6b2eab71f1fdb6b17ae4491f4b480f8582984 [file] [log] [blame]
Dan Handley9df48042015-03-19 18:58:55 +00001/*
Madhukar Pappireddyd7419442020-01-27 15:38:26 -06002 * Copyright (c) 2015-2020, ARM Limited and Contributors. All rights reserved.
Dan Handley9df48042015-03-19 18:58:55 +00003 *
dp-armfa3cf0b2017-05-03 09:38:09 +01004 * SPDX-License-Identifier: BSD-3-Clause
Dan Handley9df48042015-03-19 18:58:55 +00005 */
Antonio Nino Diaz6f3ccc52018-07-20 09:17:26 +01006#ifndef ARM_DEF_H
7#define ARM_DEF_H
Dan Handley9df48042015-03-19 18:58:55 +00008
Antonio Nino Diaze0f90632018-12-14 00:18:21 +00009#include <arch.h>
10#include <common/interrupt_props.h>
11#include <common/tbbr/tbbr_img_def.h>
12#include <drivers/arm/gic_common.h>
13#include <lib/utils_def.h>
14#include <lib/xlat_tables/xlat_tables_defs.h>
Manish V Badarkhe55861512020-03-27 13:25:51 +000015#include <plat/arm/common/smccc_def.h>
Antonio Nino Diaze0f90632018-12-14 00:18:21 +000016#include <plat/common/common_def.h>
Dan Handley9df48042015-03-19 18:58:55 +000017
18/******************************************************************************
19 * Definitions common to all ARM standard platforms
20 *****************************************************************************/
21
Max Shvetsov06dba292019-12-06 11:50:12 +000022/*
23 * Root of trust key hash lengths
24 */
25#define ARM_ROTPK_HEADER_LEN 19
26#define ARM_ROTPK_HASH_LEN 32
27
Juan Castillo7d199412015-12-14 09:35:25 +000028/* Special value used to verify platform parameters from BL2 to BL31 */
Antonio Nino Diazab5d2b12018-10-30 16:12:32 +000029#define ARM_BL31_PLAT_PARAM_VAL ULL(0x0f1e2d3c4b5a6978)
Dan Handley9df48042015-03-19 18:58:55 +000030
Deepika Bhavnani4287c0c2019-12-13 10:23:18 -060031#define ARM_SYSTEM_COUNT U(1)
Dan Handley9df48042015-03-19 18:58:55 +000032
33#define ARM_CACHE_WRITEBACK_SHIFT 6
34
Soby Mathewfec4eb72015-07-01 16:16:20 +010035/*
36 * Macros mapping the MPIDR Affinity levels to ARM Platform Power levels. The
37 * power levels have a 1:1 mapping with the MPIDR affinity levels.
38 */
39#define ARM_PWR_LVL0 MPIDR_AFFLVL0
40#define ARM_PWR_LVL1 MPIDR_AFFLVL1
Soby Mathewa869de12015-05-08 10:18:59 +010041#define ARM_PWR_LVL2 MPIDR_AFFLVL2
Chandni Cherukuri9ec4a112018-10-16 14:42:19 +053042#define ARM_PWR_LVL3 MPIDR_AFFLVL3
Soby Mathewfec4eb72015-07-01 16:16:20 +010043
44/*
45 * Macros for local power states in ARM platforms encoded by State-ID field
46 * within the power-state parameter.
47 */
48/* Local power state for power domains in Run state. */
Antonio Nino Diaz6f3ccc52018-07-20 09:17:26 +010049#define ARM_LOCAL_STATE_RUN U(0)
Soby Mathewfec4eb72015-07-01 16:16:20 +010050/* Local power state for retention. Valid only for CPU power domains */
Antonio Nino Diaz6f3ccc52018-07-20 09:17:26 +010051#define ARM_LOCAL_STATE_RET U(1)
Soby Mathewfec4eb72015-07-01 16:16:20 +010052/* Local power state for OFF/power-down. Valid for CPU and cluster power
53 domains */
Antonio Nino Diaz6f3ccc52018-07-20 09:17:26 +010054#define ARM_LOCAL_STATE_OFF U(2)
Soby Mathewfec4eb72015-07-01 16:16:20 +010055
Dan Handley9df48042015-03-19 18:58:55 +000056/* Memory location options for TSP */
57#define ARM_TRUSTED_SRAM_ID 0
58#define ARM_TRUSTED_DRAM_ID 1
59#define ARM_DRAM_ID 2
60
61/* The first 4KB of Trusted SRAM are used as shared memory */
Antonio Nino Diaz5f475792018-10-15 14:58:11 +010062#define ARM_TRUSTED_SRAM_BASE UL(0x04000000)
Dan Handley9df48042015-03-19 18:58:55 +000063#define ARM_SHARED_RAM_BASE ARM_TRUSTED_SRAM_BASE
Antonio Nino Diaz5f475792018-10-15 14:58:11 +010064#define ARM_SHARED_RAM_SIZE UL(0x00001000) /* 4 KB */
Dan Handley9df48042015-03-19 18:58:55 +000065
66/* The remaining Trusted SRAM is used to load the BL images */
67#define ARM_BL_RAM_BASE (ARM_SHARED_RAM_BASE + \
68 ARM_SHARED_RAM_SIZE)
69#define ARM_BL_RAM_SIZE (PLAT_ARM_TRUSTED_SRAM_SIZE - \
70 ARM_SHARED_RAM_SIZE)
71
72/*
73 * The top 16MB of DRAM1 is configured as secure access only using the TZC
74 * - SCP TZC DRAM: If present, DRAM reserved for SCP use
75 * - AP TZC DRAM: The remaining TZC secured DRAM reserved for AP use
76 */
Antonio Nino Diaz5f475792018-10-15 14:58:11 +010077#define ARM_TZC_DRAM1_SIZE UL(0x01000000)
Dan Handley9df48042015-03-19 18:58:55 +000078
79#define ARM_SCP_TZC_DRAM1_BASE (ARM_DRAM1_BASE + \
80 ARM_DRAM1_SIZE - \
81 ARM_SCP_TZC_DRAM1_SIZE)
82#define ARM_SCP_TZC_DRAM1_SIZE PLAT_ARM_SCP_TZC_DRAM1_SIZE
83#define ARM_SCP_TZC_DRAM1_END (ARM_SCP_TZC_DRAM1_BASE + \
84 ARM_SCP_TZC_DRAM1_SIZE - 1)
85
Soby Mathew3b5156e2017-10-05 12:27:33 +010086/*
87 * Define a 2MB region within the TZC secured DRAM for use by EL3 runtime
88 * firmware. This region is meant to be NOLOAD and will not be zero
89 * initialized. Data sections with the attribute `arm_el3_tzc_dram` will be
90 * placed here.
91 */
92#define ARM_EL3_TZC_DRAM1_BASE (ARM_SCP_TZC_DRAM1_BASE - ARM_EL3_TZC_DRAM1_SIZE)
Antonio Nino Diaz5f475792018-10-15 14:58:11 +010093#define ARM_EL3_TZC_DRAM1_SIZE UL(0x00200000) /* 2 MB */
Soby Mathew3b5156e2017-10-05 12:27:33 +010094#define ARM_EL3_TZC_DRAM1_END (ARM_EL3_TZC_DRAM1_BASE + \
95 ARM_EL3_TZC_DRAM1_SIZE - 1)
96
Dan Handley9df48042015-03-19 18:58:55 +000097#define ARM_AP_TZC_DRAM1_BASE (ARM_DRAM1_BASE + \
98 ARM_DRAM1_SIZE - \
99 ARM_TZC_DRAM1_SIZE)
100#define ARM_AP_TZC_DRAM1_SIZE (ARM_TZC_DRAM1_SIZE - \
Soby Mathew3b5156e2017-10-05 12:27:33 +0100101 (ARM_SCP_TZC_DRAM1_SIZE + \
102 ARM_EL3_TZC_DRAM1_SIZE))
Dan Handley9df48042015-03-19 18:58:55 +0000103#define ARM_AP_TZC_DRAM1_END (ARM_AP_TZC_DRAM1_BASE + \
104 ARM_AP_TZC_DRAM1_SIZE - 1)
105
Soby Mathew7e4d6652017-05-10 11:50:30 +0100106/* Define the Access permissions for Secure peripherals to NS_DRAM */
107#if ARM_CRYPTOCELL_INTEG
108/*
109 * Allow Secure peripheral to read NS DRAM when integrated with CryptoCell.
110 * This is required by CryptoCell to authenticate BL33 which is loaded
111 * into the Non Secure DDR.
112 */
113#define ARM_TZC_NS_DRAM_S_ACCESS TZC_REGION_S_RD
114#else
115#define ARM_TZC_NS_DRAM_S_ACCESS TZC_REGION_S_NONE
116#endif
117
Summer Qin9db8f2e2017-04-24 16:49:28 +0100118#ifdef SPD_opteed
119/*
Jens Wiklanderae73b162017-08-24 15:39:09 +0200120 * BL2 needs to map 4MB at the end of TZC_DRAM1 in order to
121 * load/authenticate the trusted os extra image. The first 512KB of
122 * TZC_DRAM1 are reserved for trusted os (OPTEE). The extra image loading
123 * for OPTEE is paged image which only include the paging part using
124 * virtual memory but without "init" data. OPTEE will copy the "init" data
125 * (from pager image) to the first 512KB of TZC_DRAM, and then copy the
126 * extra image behind the "init" data.
Summer Qin9db8f2e2017-04-24 16:49:28 +0100127 */
Jens Wiklanderae73b162017-08-24 15:39:09 +0200128#define ARM_OPTEE_PAGEABLE_LOAD_BASE (ARM_AP_TZC_DRAM1_BASE + \
129 ARM_AP_TZC_DRAM1_SIZE - \
130 ARM_OPTEE_PAGEABLE_LOAD_SIZE)
Antonio Nino Diaz5f475792018-10-15 14:58:11 +0100131#define ARM_OPTEE_PAGEABLE_LOAD_SIZE UL(0x400000)
Summer Qin9db8f2e2017-04-24 16:49:28 +0100132#define ARM_OPTEE_PAGEABLE_LOAD_MEM MAP_REGION_FLAT( \
133 ARM_OPTEE_PAGEABLE_LOAD_BASE, \
134 ARM_OPTEE_PAGEABLE_LOAD_SIZE, \
135 MT_MEMORY | MT_RW | MT_SECURE)
Soby Mathew874fc9e2017-09-01 13:43:50 +0100136
137/*
138 * Map the memory for the OP-TEE core (also known as OP-TEE pager when paging
139 * support is enabled).
140 */
141#define ARM_MAP_OPTEE_CORE_MEM MAP_REGION_FLAT( \
142 BL32_BASE, \
143 BL32_LIMIT - BL32_BASE, \
144 MT_MEMORY | MT_RW | MT_SECURE)
Summer Qin9db8f2e2017-04-24 16:49:28 +0100145#endif /* SPD_opteed */
Dan Handley9df48042015-03-19 18:58:55 +0000146
147#define ARM_NS_DRAM1_BASE ARM_DRAM1_BASE
148#define ARM_NS_DRAM1_SIZE (ARM_DRAM1_SIZE - \
149 ARM_TZC_DRAM1_SIZE)
150#define ARM_NS_DRAM1_END (ARM_NS_DRAM1_BASE + \
151 ARM_NS_DRAM1_SIZE - 1)
152
Sandrine Bailleux6c32fc72018-10-31 14:28:17 +0100153#define ARM_DRAM1_BASE ULL(0x80000000)
154#define ARM_DRAM1_SIZE ULL(0x80000000)
Dan Handley9df48042015-03-19 18:58:55 +0000155#define ARM_DRAM1_END (ARM_DRAM1_BASE + \
156 ARM_DRAM1_SIZE - 1)
157
Sami Mujawara43ae7c2019-05-09 13:35:02 +0100158#define ARM_DRAM2_BASE PLAT_ARM_DRAM2_BASE
Dan Handley9df48042015-03-19 18:58:55 +0000159#define ARM_DRAM2_SIZE PLAT_ARM_DRAM2_SIZE
160#define ARM_DRAM2_END (ARM_DRAM2_BASE + \
161 ARM_DRAM2_SIZE - 1)
162
163#define ARM_IRQ_SEC_PHY_TIMER 29
164
165#define ARM_IRQ_SEC_SGI_0 8
166#define ARM_IRQ_SEC_SGI_1 9
167#define ARM_IRQ_SEC_SGI_2 10
168#define ARM_IRQ_SEC_SGI_3 11
169#define ARM_IRQ_SEC_SGI_4 12
170#define ARM_IRQ_SEC_SGI_5 13
171#define ARM_IRQ_SEC_SGI_6 14
172#define ARM_IRQ_SEC_SGI_7 15
173
Achin Gupta1fa7eb62015-11-03 14:18:34 +0000174/*
Jeenu Viswambharan723dce02017-09-22 08:59:59 +0100175 * Define a list of Group 1 Secure and Group 0 interrupt properties as per GICv3
176 * terminology. On a GICv2 system or mode, the lists will be merged and treated
177 * as Group 0 interrupts.
178 */
179#define ARM_G1S_IRQ_PROPS(grp) \
Antonio Nino Diaze590fd52018-08-21 09:42:26 +0100180 INTR_PROP_DESC(ARM_IRQ_SEC_PHY_TIMER, GIC_HIGHEST_SEC_PRIORITY, (grp), \
Jeenu Viswambharan723dce02017-09-22 08:59:59 +0100181 GIC_INTR_CFG_LEVEL), \
Antonio Nino Diaze590fd52018-08-21 09:42:26 +0100182 INTR_PROP_DESC(ARM_IRQ_SEC_SGI_1, GIC_HIGHEST_SEC_PRIORITY, (grp), \
Jeenu Viswambharan723dce02017-09-22 08:59:59 +0100183 GIC_INTR_CFG_EDGE), \
Antonio Nino Diaze590fd52018-08-21 09:42:26 +0100184 INTR_PROP_DESC(ARM_IRQ_SEC_SGI_2, GIC_HIGHEST_SEC_PRIORITY, (grp), \
Jeenu Viswambharan723dce02017-09-22 08:59:59 +0100185 GIC_INTR_CFG_EDGE), \
Antonio Nino Diaze590fd52018-08-21 09:42:26 +0100186 INTR_PROP_DESC(ARM_IRQ_SEC_SGI_3, GIC_HIGHEST_SEC_PRIORITY, (grp), \
Jeenu Viswambharan723dce02017-09-22 08:59:59 +0100187 GIC_INTR_CFG_EDGE), \
Antonio Nino Diaze590fd52018-08-21 09:42:26 +0100188 INTR_PROP_DESC(ARM_IRQ_SEC_SGI_4, GIC_HIGHEST_SEC_PRIORITY, (grp), \
Jeenu Viswambharan723dce02017-09-22 08:59:59 +0100189 GIC_INTR_CFG_EDGE), \
Antonio Nino Diaze590fd52018-08-21 09:42:26 +0100190 INTR_PROP_DESC(ARM_IRQ_SEC_SGI_5, GIC_HIGHEST_SEC_PRIORITY, (grp), \
Jeenu Viswambharan723dce02017-09-22 08:59:59 +0100191 GIC_INTR_CFG_EDGE), \
Antonio Nino Diaze590fd52018-08-21 09:42:26 +0100192 INTR_PROP_DESC(ARM_IRQ_SEC_SGI_7, GIC_HIGHEST_SEC_PRIORITY, (grp), \
Jeenu Viswambharan723dce02017-09-22 08:59:59 +0100193 GIC_INTR_CFG_EDGE)
194
195#define ARM_G0_IRQ_PROPS(grp) \
Antonio Nino Diaze590fd52018-08-21 09:42:26 +0100196 INTR_PROP_DESC(ARM_IRQ_SEC_SGI_0, PLAT_SDEI_NORMAL_PRI, (grp), \
Jeenu Viswambharan723dce02017-09-22 08:59:59 +0100197 GIC_INTR_CFG_EDGE), \
Antonio Nino Diaze590fd52018-08-21 09:42:26 +0100198 INTR_PROP_DESC(ARM_IRQ_SEC_SGI_6, GIC_HIGHEST_SEC_PRIORITY, (grp), \
Jeenu Viswambharan723dce02017-09-22 08:59:59 +0100199 GIC_INTR_CFG_EDGE)
200
Dan Handley9df48042015-03-19 18:58:55 +0000201#define ARM_MAP_SHARED_RAM MAP_REGION_FLAT( \
202 ARM_SHARED_RAM_BASE, \
203 ARM_SHARED_RAM_SIZE, \
Juan Castillo2e86cb12016-01-13 15:01:09 +0000204 MT_DEVICE | MT_RW | MT_SECURE)
Dan Handley9df48042015-03-19 18:58:55 +0000205
206#define ARM_MAP_NS_DRAM1 MAP_REGION_FLAT( \
207 ARM_NS_DRAM1_BASE, \
208 ARM_NS_DRAM1_SIZE, \
209 MT_MEMORY | MT_RW | MT_NS)
210
Roberto Vargasf8fda102017-08-08 11:27:20 +0100211#define ARM_MAP_DRAM2 MAP_REGION_FLAT( \
212 ARM_DRAM2_BASE, \
213 ARM_DRAM2_SIZE, \
214 MT_MEMORY | MT_RW | MT_NS)
Roberto Vargasf8fda102017-08-08 11:27:20 +0100215
Dan Handley9df48042015-03-19 18:58:55 +0000216#define ARM_MAP_TSP_SEC_MEM MAP_REGION_FLAT( \
217 TSP_SEC_MEM_BASE, \
218 TSP_SEC_MEM_SIZE, \
219 MT_MEMORY | MT_RW | MT_SECURE)
220
David Wang0ba499f2016-03-07 11:02:57 +0800221#if ARM_BL31_IN_DRAM
222#define ARM_MAP_BL31_SEC_DRAM MAP_REGION_FLAT( \
223 BL31_BASE, \
224 PLAT_ARM_MAX_BL31_SIZE, \
225 MT_MEMORY | MT_RW | MT_SECURE)
226#endif
Dan Handley9df48042015-03-19 18:58:55 +0000227
Soby Mathew3b5156e2017-10-05 12:27:33 +0100228#define ARM_MAP_EL3_TZC_DRAM MAP_REGION_FLAT( \
229 ARM_EL3_TZC_DRAM1_BASE, \
230 ARM_EL3_TZC_DRAM1_SIZE, \
231 MT_MEMORY | MT_RW | MT_SECURE)
232
Achin Guptae97351d2019-10-11 15:15:19 +0100233#if defined(SPD_spmd)
234#define ARM_MAP_TRUSTED_DRAM MAP_REGION_FLAT( \
235 PLAT_ARM_TRUSTED_DRAM_BASE, \
236 PLAT_ARM_TRUSTED_DRAM_SIZE, \
237 MT_MEMORY | MT_RW | MT_SECURE)
238#endif
239
240
Daniel Boulby4e97abd2018-07-16 14:09:15 +0100241/*
John Tsichritzisc34341a2018-07-30 13:41:52 +0100242 * Mapping for the BL1 RW region. This mapping is needed by BL2 in order to
243 * share the Mbed TLS heap. Since the heap is allocated inside BL1, it resides
244 * in the BL1 RW region. Hence, BL2 needs access to the BL1 RW region in order
245 * to be able to access the heap.
246 */
247#define ARM_MAP_BL1_RW MAP_REGION_FLAT( \
248 BL1_RW_BASE, \
249 BL1_RW_LIMIT - BL1_RW_BASE, \
250 MT_MEMORY | MT_RW | MT_SECURE)
251
252/*
Daniel Boulby4e97abd2018-07-16 14:09:15 +0100253 * If SEPARATE_CODE_AND_RODATA=1 we define a region for each section
254 * otherwise one region is defined containing both.
255 */
Daniel Boulby45a2c9e2018-07-06 16:54:44 +0100256#if SEPARATE_CODE_AND_RODATA
Daniel Boulby4e97abd2018-07-16 14:09:15 +0100257#define ARM_MAP_BL_RO MAP_REGION_FLAT( \
Daniel Boulby45a2c9e2018-07-06 16:54:44 +0100258 BL_CODE_BASE, \
259 BL_CODE_END - BL_CODE_BASE, \
Daniel Boulby4e97abd2018-07-16 14:09:15 +0100260 MT_CODE | MT_SECURE), \
261 MAP_REGION_FLAT( \
Daniel Boulby45a2c9e2018-07-06 16:54:44 +0100262 BL_RO_DATA_BASE, \
263 BL_RO_DATA_END \
264 - BL_RO_DATA_BASE, \
265 MT_RO_DATA | MT_SECURE)
Daniel Boulby4e97abd2018-07-16 14:09:15 +0100266#else
267#define ARM_MAP_BL_RO MAP_REGION_FLAT( \
268 BL_CODE_BASE, \
269 BL_CODE_END - BL_CODE_BASE, \
270 MT_CODE | MT_SECURE)
Daniel Boulby45a2c9e2018-07-06 16:54:44 +0100271#endif
272#if USE_COHERENT_MEM
273#define ARM_MAP_BL_COHERENT_RAM MAP_REGION_FLAT( \
274 BL_COHERENT_RAM_BASE, \
275 BL_COHERENT_RAM_END \
276 - BL_COHERENT_RAM_BASE, \
277 MT_DEVICE | MT_RW | MT_SECURE)
278#endif
Roberto Vargase3adc372018-05-23 09:27:06 +0100279#if USE_ROMLIB
280#define ARM_MAP_ROMLIB_CODE MAP_REGION_FLAT( \
281 ROMLIB_RO_BASE, \
282 ROMLIB_RO_LIMIT - ROMLIB_RO_BASE,\
283 MT_CODE | MT_SECURE)
284
285#define ARM_MAP_ROMLIB_DATA MAP_REGION_FLAT( \
286 ROMLIB_RW_BASE, \
287 ROMLIB_RW_END - ROMLIB_RW_BASE,\
288 MT_MEMORY | MT_RW | MT_SECURE)
289#endif
Daniel Boulby45a2c9e2018-07-06 16:54:44 +0100290
Dan Handley9df48042015-03-19 18:58:55 +0000291/*
Antonio Nino Diaz48bfb542018-10-11 13:02:34 +0100292 * Map mem_protect flash region with read and write permissions
293 */
294#define ARM_V2M_MAP_MEM_PROTECT MAP_REGION_FLAT(PLAT_ARM_MEM_PROT_ADDR, \
295 V2M_FLASH_BLOCK_SIZE, \
296 MT_DEVICE | MT_RW | MT_SECURE)
297
298/*
Daniel Boulby4e97abd2018-07-16 14:09:15 +0100299 * The max number of regions like RO(code), coherent and data required by
Dan Handley9df48042015-03-19 18:58:55 +0000300 * different BL stages which need to be mapped in the MMU.
301 */
Daniel Boulbyb1b058d2018-09-18 11:52:49 +0100302#define ARM_BL_REGIONS 5
Dan Handley9df48042015-03-19 18:58:55 +0000303
304#define MAX_MMAP_REGIONS (PLAT_ARM_MMAP_ENTRIES + \
305 ARM_BL_REGIONS)
306
307/* Memory mapped Generic timer interfaces */
Antonio Nino Diaz5f475792018-10-15 14:58:11 +0100308#define ARM_SYS_CNTCTL_BASE UL(0x2a430000)
309#define ARM_SYS_CNTREAD_BASE UL(0x2a800000)
310#define ARM_SYS_TIMCTL_BASE UL(0x2a810000)
311#define ARM_SYS_CNT_BASE_S UL(0x2a820000)
312#define ARM_SYS_CNT_BASE_NS UL(0x2a830000)
Dan Handley9df48042015-03-19 18:58:55 +0000313
314#define ARM_CONSOLE_BAUDRATE 115200
315
Juan Castillob6132f12015-10-06 14:01:35 +0100316/* Trusted Watchdog constants */
Antonio Nino Diaz5f475792018-10-15 14:58:11 +0100317#define ARM_SP805_TWDG_BASE UL(0x2a490000)
Juan Castillob6132f12015-10-06 14:01:35 +0100318#define ARM_SP805_TWDG_CLK_HZ 32768
319/* The TBBR document specifies a watchdog timeout of 256 seconds. SP805
320 * asserts reset after two consecutive countdowns (2 x 128 = 256 sec) */
321#define ARM_TWDG_TIMEOUT_SEC 128
322#define ARM_TWDG_LOAD_VAL (ARM_SP805_TWDG_CLK_HZ * \
323 ARM_TWDG_TIMEOUT_SEC)
324
Dan Handley9df48042015-03-19 18:58:55 +0000325/******************************************************************************
326 * Required platform porting definitions common to all ARM standard platforms
327 *****************************************************************************/
328
Roberto Vargasf8fda102017-08-08 11:27:20 +0100329/*
Soby Mathewfec4eb72015-07-01 16:16:20 +0100330 * This macro defines the deepest retention state possible. A higher state
331 * id will represent an invalid or a power down state.
332 */
333#define PLAT_MAX_RET_STATE ARM_LOCAL_STATE_RET
334
335/*
336 * This macro defines the deepest power down states possible. Any state ID
337 * higher than this is invalid.
338 */
339#define PLAT_MAX_OFF_STATE ARM_LOCAL_STATE_OFF
340
Dan Handley9df48042015-03-19 18:58:55 +0000341/*
342 * Some data must be aligned on the biggest cache line size in the platform.
343 * This is known only to the platform as it might have a combination of
344 * integrated and external caches.
345 */
Antonio Nino Diaz5f475792018-10-15 14:58:11 +0100346#define CACHE_WRITEBACK_GRANULE (U(1) << ARM_CACHE_WRITEBACK_SHIFT)
Dan Handley9df48042015-03-19 18:58:55 +0000347
Soby Mathew7c6df5b2018-01-15 14:43:42 +0000348/*
Manish V Badarkhe1da211a2020-05-31 10:17:59 +0100349 * To enable FW_CONFIG to be loaded by BL1, define the corresponding base
Soby Mathew7c6df5b2018-01-15 14:43:42 +0000350 * and limit. Leave enough space of BL2 meminfo.
351 */
Manish V Badarkhe1da211a2020-05-31 10:17:59 +0100352#define ARM_FW_CONFIG_BASE (ARM_BL_RAM_BASE + sizeof(meminfo_t))
353#define ARM_FW_CONFIG_LIMIT (ARM_BL_RAM_BASE + (PAGE_SIZE / 2U))
Sathees Balya90950092018-11-15 14:22:30 +0000354
355/*
356 * Boot parameters passed from BL2 to BL31/BL32 are stored here
357 */
Manish V Badarkhe1da211a2020-05-31 10:17:59 +0100358#define ARM_BL2_MEM_DESC_BASE ARM_FW_CONFIG_LIMIT
Sathees Balya90950092018-11-15 14:22:30 +0000359#define ARM_BL2_MEM_DESC_LIMIT (ARM_BL2_MEM_DESC_BASE + \
360 (PAGE_SIZE / 2U))
361
362/*
363 * Define limit of firmware configuration memory:
Manish V Badarkhe1da211a2020-05-31 10:17:59 +0100364 * ARM_FW_CONFIG + ARM_BL2_MEM_DESC memory
Sathees Balya90950092018-11-15 14:22:30 +0000365 */
Manish V Badarkhe1da211a2020-05-31 10:17:59 +0100366#define ARM_FW_CONFIGS_LIMIT (ARM_BL_RAM_BASE + PAGE_SIZE)
Dan Handley9df48042015-03-19 18:58:55 +0000367
368/*******************************************************************************
369 * BL1 specific defines.
370 * BL1 RW data is relocated from ROM to RAM at runtime so we need 2 sets of
371 * addresses.
372 ******************************************************************************/
373#define BL1_RO_BASE PLAT_ARM_TRUSTED_ROM_BASE
374#define BL1_RO_LIMIT (PLAT_ARM_TRUSTED_ROM_BASE \
Roberto Vargase3adc372018-05-23 09:27:06 +0100375 + (PLAT_ARM_TRUSTED_ROM_SIZE - \
376 PLAT_ARM_MAX_ROMLIB_RO_SIZE))
Dan Handley9df48042015-03-19 18:58:55 +0000377/*
Vikram Kanigiri5d86f2e2016-01-21 14:08:15 +0000378 * Put BL1 RW at the top of the Trusted SRAM.
Dan Handley9df48042015-03-19 18:58:55 +0000379 */
Dan Handley9df48042015-03-19 18:58:55 +0000380#define BL1_RW_BASE (ARM_BL_RAM_BASE + \
381 ARM_BL_RAM_SIZE - \
Roberto Vargase3adc372018-05-23 09:27:06 +0100382 (PLAT_ARM_MAX_BL1_RW_SIZE +\
383 PLAT_ARM_MAX_ROMLIB_RW_SIZE))
384#define BL1_RW_LIMIT (ARM_BL_RAM_BASE + \
385 (ARM_BL_RAM_SIZE - PLAT_ARM_MAX_ROMLIB_RW_SIZE))
386
387#define ROMLIB_RO_BASE BL1_RO_LIMIT
388#define ROMLIB_RO_LIMIT (PLAT_ARM_TRUSTED_ROM_BASE + PLAT_ARM_TRUSTED_ROM_SIZE)
389
390#define ROMLIB_RW_BASE (BL1_RW_BASE + PLAT_ARM_MAX_BL1_RW_SIZE)
391#define ROMLIB_RW_END (ROMLIB_RW_BASE + PLAT_ARM_MAX_ROMLIB_RW_SIZE)
Dan Handley9df48042015-03-19 18:58:55 +0000392
393/*******************************************************************************
394 * BL2 specific defines.
395 ******************************************************************************/
Soby Mathewaf14b462018-06-01 16:53:38 +0100396#if BL2_AT_EL3
Dimitris Papastamos25836492018-06-11 11:07:58 +0100397/* Put BL2 towards the middle of the Trusted SRAM */
Soby Mathewaf14b462018-06-01 16:53:38 +0100398#define BL2_BASE (ARM_TRUSTED_SRAM_BASE + \
Dimitris Papastamos25836492018-06-11 11:07:58 +0100399 (PLAT_ARM_TRUSTED_SRAM_SIZE >> 1) + 0x2000)
Roberto Vargas52207802017-11-17 13:22:18 +0000400#define BL2_LIMIT (ARM_BL_RAM_BASE + ARM_BL_RAM_SIZE)
401
David Wang0ba499f2016-03-07 11:02:57 +0800402#else
Dan Handley9df48042015-03-19 18:58:55 +0000403/*
Soby Mathewaf14b462018-06-01 16:53:38 +0100404 * Put BL2 just below BL1.
Dan Handley9df48042015-03-19 18:58:55 +0000405 */
Soby Mathewaf14b462018-06-01 16:53:38 +0100406#define BL2_BASE (BL1_RW_BASE - PLAT_ARM_MAX_BL2_SIZE)
407#define BL2_LIMIT BL1_RW_BASE
David Wang0ba499f2016-03-07 11:02:57 +0800408#endif
Dan Handley9df48042015-03-19 18:58:55 +0000409
410/*******************************************************************************
Juan Castillo7d199412015-12-14 09:35:25 +0000411 * BL31 specific defines.
Dan Handley9df48042015-03-19 18:58:55 +0000412 ******************************************************************************/
Madhukar Pappireddyd7419442020-01-27 15:38:26 -0600413#if ARM_BL31_IN_DRAM || SEPARATE_NOBITS_REGION
David Wang0ba499f2016-03-07 11:02:57 +0800414/*
415 * Put BL31 at the bottom of TZC secured DRAM
416 */
417#define BL31_BASE ARM_AP_TZC_DRAM1_BASE
418#define BL31_LIMIT (ARM_AP_TZC_DRAM1_BASE + \
419 PLAT_ARM_MAX_BL31_SIZE)
Madhukar Pappireddyd7419442020-01-27 15:38:26 -0600420/*
421 * For SEPARATE_NOBITS_REGION, BL31 PROGBITS are loaded in TZC secured DRAM.
422 * And BL31 NOBITS are loaded in Trusted SRAM such that BL2 is overwritten.
423 */
424#if SEPARATE_NOBITS_REGION
425#define BL31_NOBITS_BASE BL2_BASE
426#define BL31_NOBITS_LIMIT BL2_LIMIT
427#endif /* SEPARATE_NOBITS_REGION */
Qixiang Xua5f72812017-08-31 11:45:32 +0800428#elif (RESET_TO_BL31)
Manish Pandey2207e932019-11-06 13:17:46 +0000429/* Ensure Position Independent support (PIE) is enabled for this config.*/
430# if !ENABLE_PIE
431# error "BL31 must be a PIE if RESET_TO_BL31=1."
432#endif
Qixiang Xua5f72812017-08-31 11:45:32 +0800433/*
Soby Mathew68e69282018-12-12 14:13:52 +0000434 * Since this is PIE, we can define BL31_BASE to 0x0 since this macro is solely
Soby Mathewc5e17452019-01-07 14:07:58 +0000435 * used for building BL31 and not used for loading BL31.
Qixiang Xua5f72812017-08-31 11:45:32 +0800436 */
Soby Mathewc5e17452019-01-07 14:07:58 +0000437# define BL31_BASE 0x0
438# define BL31_LIMIT PLAT_ARM_MAX_BL31_SIZE
David Wang0ba499f2016-03-07 11:02:57 +0800439#else
Soby Mathewaf14b462018-06-01 16:53:38 +0100440/* Put BL31 below BL2 in the Trusted SRAM.*/
441#define BL31_BASE ((ARM_BL_RAM_BASE + ARM_BL_RAM_SIZE)\
442 - PLAT_ARM_MAX_BL31_SIZE)
443#define BL31_PROGBITS_LIMIT BL2_BASE
Dimitris Papastamos25836492018-06-11 11:07:58 +0100444/*
445 * For BL2_AT_EL3 make sure the BL31 can grow up until BL2_BASE. This is
446 * because in the BL2_AT_EL3 configuration, BL2 is always resident.
447 */
448#if BL2_AT_EL3
449#define BL31_LIMIT BL2_BASE
450#else
Dan Handley9df48042015-03-19 18:58:55 +0000451#define BL31_LIMIT (ARM_BL_RAM_BASE + ARM_BL_RAM_SIZE)
David Wang0ba499f2016-03-07 11:02:57 +0800452#endif
Dimitris Papastamos25836492018-06-11 11:07:58 +0100453#endif
Dan Handley9df48042015-03-19 18:58:55 +0000454
Julius Werner8e0ef0f2019-07-09 14:02:43 -0700455#if !defined(__aarch64__) || JUNO_AARCH32_EL3_RUNTIME
Dan Handley9df48042015-03-19 18:58:55 +0000456/*******************************************************************************
Soby Mathewbf169232017-11-14 14:10:10 +0000457 * BL32 specific defines for EL3 runtime in AArch32 mode
458 ******************************************************************************/
459# if RESET_TO_SP_MIN && !JUNO_AARCH32_EL3_RUNTIME
Soby Mathewaf14b462018-06-01 16:53:38 +0100460/*
461 * SP_MIN is the only BL image in SRAM. Allocate the whole of SRAM (excluding
462 * the page reserved for fw_configs) to BL32
463 */
Manish V Badarkhe1da211a2020-05-31 10:17:59 +0100464# define BL32_BASE ARM_FW_CONFIGS_LIMIT
Soby Mathewbf169232017-11-14 14:10:10 +0000465# define BL32_LIMIT (ARM_BL_RAM_BASE + ARM_BL_RAM_SIZE)
466# else
Soby Mathewaf14b462018-06-01 16:53:38 +0100467/* Put BL32 below BL2 in the Trusted SRAM.*/
468# define BL32_BASE ((ARM_BL_RAM_BASE + ARM_BL_RAM_SIZE)\
469 - PLAT_ARM_MAX_BL32_SIZE)
470# define BL32_PROGBITS_LIMIT BL2_BASE
Soby Mathewbf169232017-11-14 14:10:10 +0000471# define BL32_LIMIT (ARM_BL_RAM_BASE + ARM_BL_RAM_SIZE)
472# endif /* RESET_TO_SP_MIN && !JUNO_AARCH32_EL3_RUNTIME */
473
474#else
475/*******************************************************************************
476 * BL32 specific defines for EL3 runtime in AArch64 mode
Dan Handley9df48042015-03-19 18:58:55 +0000477 ******************************************************************************/
478/*
479 * On ARM standard platforms, the TSP can execute from Trusted SRAM,
480 * Trusted DRAM (if available) or the DRAM region secured by the TrustZone
481 * controller.
482 */
Paul Beesleydb4e25a2019-10-14 15:27:12 +0000483# if SPM_MM
Soby Mathewbf169232017-11-14 14:10:10 +0000484# define TSP_SEC_MEM_BASE (ARM_AP_TZC_DRAM1_BASE + ULL(0x200000))
485# define TSP_SEC_MEM_SIZE (ARM_AP_TZC_DRAM1_SIZE - ULL(0x200000))
486# define BL32_BASE (ARM_AP_TZC_DRAM1_BASE + ULL(0x200000))
487# define BL32_LIMIT (ARM_AP_TZC_DRAM1_BASE + \
Antonio Nino Diaz7289f922017-11-09 11:34:09 +0000488 ARM_AP_TZC_DRAM1_SIZE)
Achin Guptae97351d2019-10-11 15:15:19 +0100489# elif defined(SPD_spmd)
490# define TSP_SEC_MEM_BASE (ARM_AP_TZC_DRAM1_BASE + ULL(0x200000))
491# define TSP_SEC_MEM_SIZE (ARM_AP_TZC_DRAM1_SIZE - ULL(0x200000))
492# define BL32_BASE PLAT_ARM_TRUSTED_DRAM_BASE
493# define BL32_LIMIT (PLAT_ARM_TRUSTED_DRAM_BASE \
494 + (UL(1) << 21))
Soby Mathewbf169232017-11-14 14:10:10 +0000495# elif ARM_BL31_IN_DRAM
496# define TSP_SEC_MEM_BASE (ARM_AP_TZC_DRAM1_BASE + \
David Wang0ba499f2016-03-07 11:02:57 +0800497 PLAT_ARM_MAX_BL31_SIZE)
Soby Mathewbf169232017-11-14 14:10:10 +0000498# define TSP_SEC_MEM_SIZE (ARM_AP_TZC_DRAM1_SIZE - \
David Wang0ba499f2016-03-07 11:02:57 +0800499 PLAT_ARM_MAX_BL31_SIZE)
Soby Mathewbf169232017-11-14 14:10:10 +0000500# define BL32_BASE (ARM_AP_TZC_DRAM1_BASE + \
David Wang0ba499f2016-03-07 11:02:57 +0800501 PLAT_ARM_MAX_BL31_SIZE)
Soby Mathewbf169232017-11-14 14:10:10 +0000502# define BL32_LIMIT (ARM_AP_TZC_DRAM1_BASE + \
David Wang0ba499f2016-03-07 11:02:57 +0800503 ARM_AP_TZC_DRAM1_SIZE)
Soby Mathewbf169232017-11-14 14:10:10 +0000504# elif ARM_TSP_RAM_LOCATION_ID == ARM_TRUSTED_SRAM_ID
505# define TSP_SEC_MEM_BASE ARM_BL_RAM_BASE
506# define TSP_SEC_MEM_SIZE ARM_BL_RAM_SIZE
Soby Mathewaf14b462018-06-01 16:53:38 +0100507# define TSP_PROGBITS_LIMIT BL31_BASE
Manish V Badarkhe1da211a2020-05-31 10:17:59 +0100508# define BL32_BASE ARM_FW_CONFIGS_LIMIT
Soby Mathewbf169232017-11-14 14:10:10 +0000509# define BL32_LIMIT BL31_BASE
510# elif ARM_TSP_RAM_LOCATION_ID == ARM_TRUSTED_DRAM_ID
511# define TSP_SEC_MEM_BASE PLAT_ARM_TRUSTED_DRAM_BASE
512# define TSP_SEC_MEM_SIZE PLAT_ARM_TRUSTED_DRAM_SIZE
513# define BL32_BASE PLAT_ARM_TRUSTED_DRAM_BASE
514# define BL32_LIMIT (PLAT_ARM_TRUSTED_DRAM_BASE \
Antonio Nino Diazab5d2b12018-10-30 16:12:32 +0000515 + (UL(1) << 21))
Soby Mathewbf169232017-11-14 14:10:10 +0000516# elif ARM_TSP_RAM_LOCATION_ID == ARM_DRAM_ID
517# define TSP_SEC_MEM_BASE ARM_AP_TZC_DRAM1_BASE
518# define TSP_SEC_MEM_SIZE ARM_AP_TZC_DRAM1_SIZE
519# define BL32_BASE ARM_AP_TZC_DRAM1_BASE
520# define BL32_LIMIT (ARM_AP_TZC_DRAM1_BASE + \
Dan Handley9df48042015-03-19 18:58:55 +0000521 ARM_AP_TZC_DRAM1_SIZE)
Soby Mathewbf169232017-11-14 14:10:10 +0000522# else
523# error "Unsupported ARM_TSP_RAM_LOCATION_ID value"
524# endif
Julius Werner8e0ef0f2019-07-09 14:02:43 -0700525#endif /* !__aarch64__ || JUNO_AARCH32_EL3_RUNTIME */
Dan Handley9df48042015-03-19 18:58:55 +0000526
Antonio Nino Diaz7289f922017-11-09 11:34:09 +0000527/*
528 * BL32 is mandatory in AArch32. In AArch64, undefine BL32_BASE if there is no
Achin Guptae97351d2019-10-11 15:15:19 +0100529 * SPD and no SPM-MM, as they are the only ones that can be used as BL32.
Antonio Nino Diaz7289f922017-11-09 11:34:09 +0000530 */
Julius Werner8e0ef0f2019-07-09 14:02:43 -0700531#if defined(__aarch64__) && !JUNO_AARCH32_EL3_RUNTIME
Paul Beesleydb4e25a2019-10-14 15:27:12 +0000532# if defined(SPD_none) && !SPM_MM
Antonio Nino Diaz7289f922017-11-09 11:34:09 +0000533# undef BL32_BASE
Achin Guptae97351d2019-10-11 15:15:19 +0100534# endif /* defined(SPD_none) && !SPM_MM */
Julius Werner8e0ef0f2019-07-09 14:02:43 -0700535#endif /* defined(__aarch64__) && !JUNO_AARCH32_EL3_RUNTIME */
Antonio Nino Diaze4fa3702016-04-05 11:38:49 +0100536
Yatharth Kochar736a3bf2015-10-11 14:14:55 +0100537/*******************************************************************************
538 * FWU Images: NS_BL1U, BL2U & NS_BL2U defines.
539 ******************************************************************************/
540#define BL2U_BASE BL2_BASE
Soby Mathewbf169232017-11-14 14:10:10 +0000541#define BL2U_LIMIT BL2_LIMIT
542
Yatharth Kochar736a3bf2015-10-11 14:14:55 +0100543#define NS_BL2U_BASE ARM_NS_DRAM1_BASE
Antonio Nino Diazab5d2b12018-10-30 16:12:32 +0000544#define NS_BL1U_BASE (PLAT_ARM_NVM_BASE + UL(0x03EB8000))
Yatharth Kochar736a3bf2015-10-11 14:14:55 +0100545
Dan Handley9df48042015-03-19 18:58:55 +0000546/*
547 * ID of the secure physical generic timer interrupt used by the TSP.
548 */
549#define TSP_IRQ_SEC_PHY_TIMER ARM_IRQ_SEC_PHY_TIMER
550
551
Vikram Kanigirid79214c2015-09-09 10:52:13 +0100552/*
553 * One cache line needed for bakery locks on ARM platforms
554 */
555#define PLAT_PERCPU_BAKERY_LOCK_SIZE (1 * CACHE_WRITEBACK_GRANULE)
556
Jeenu Viswambharanb1837452017-10-24 11:47:13 +0100557/* Priority levels for ARM platforms */
Jeenu Viswambharana5b5b8d2018-02-06 12:21:39 +0000558#define PLAT_RAS_PRI 0x10
Jeenu Viswambharanb1837452017-10-24 11:47:13 +0100559#define PLAT_SDEI_CRITICAL_PRI 0x60
560#define PLAT_SDEI_NORMAL_PRI 0x70
561
562/* ARM platforms use 3 upper bits of secure interrupt priority */
563#define ARM_PRI_BITS 3
Vikram Kanigirid79214c2015-09-09 10:52:13 +0100564
Jeenu Viswambharana5acc0a2017-09-22 08:32:10 +0100565/* SGI used for SDEI signalling */
566#define ARM_SDEI_SGI ARM_IRQ_SEC_SGI_0
567
Balint Dobszayd0dbd5e2019-12-18 15:28:00 +0100568#if SDEI_IN_FCONF
569/* ARM SDEI dynamic private event max count */
570#define ARM_SDEI_DP_EVENT_MAX_CNT 3
571
572/* ARM SDEI dynamic shared event max count */
573#define ARM_SDEI_DS_EVENT_MAX_CNT 3
574#else
Jeenu Viswambharana5acc0a2017-09-22 08:32:10 +0100575/* ARM SDEI dynamic private event numbers */
576#define ARM_SDEI_DP_EVENT_0 1000
577#define ARM_SDEI_DP_EVENT_1 1001
578#define ARM_SDEI_DP_EVENT_2 1002
579
580/* ARM SDEI dynamic shared event numbers */
581#define ARM_SDEI_DS_EVENT_0 2000
582#define ARM_SDEI_DS_EVENT_1 2001
583#define ARM_SDEI_DS_EVENT_2 2002
584
Jeenu Viswambharan6e284462017-12-08 10:38:24 +0000585#define ARM_SDEI_PRIVATE_EVENTS \
586 SDEI_DEFINE_EVENT_0(ARM_SDEI_SGI), \
587 SDEI_PRIVATE_EVENT(ARM_SDEI_DP_EVENT_0, SDEI_DYN_IRQ, SDEI_MAPF_DYNAMIC), \
588 SDEI_PRIVATE_EVENT(ARM_SDEI_DP_EVENT_1, SDEI_DYN_IRQ, SDEI_MAPF_DYNAMIC), \
589 SDEI_PRIVATE_EVENT(ARM_SDEI_DP_EVENT_2, SDEI_DYN_IRQ, SDEI_MAPF_DYNAMIC)
590
591#define ARM_SDEI_SHARED_EVENTS \
592 SDEI_SHARED_EVENT(ARM_SDEI_DS_EVENT_0, SDEI_DYN_IRQ, SDEI_MAPF_DYNAMIC), \
593 SDEI_SHARED_EVENT(ARM_SDEI_DS_EVENT_1, SDEI_DYN_IRQ, SDEI_MAPF_DYNAMIC), \
594 SDEI_SHARED_EVENT(ARM_SDEI_DS_EVENT_2, SDEI_DYN_IRQ, SDEI_MAPF_DYNAMIC)
Balint Dobszayd0dbd5e2019-12-18 15:28:00 +0100595#endif /* SDEI_IN_FCONF */
Jeenu Viswambharan6e284462017-12-08 10:38:24 +0000596
Antonio Nino Diaz6f3ccc52018-07-20 09:17:26 +0100597#endif /* ARM_DEF_H */