Debian Codegraph @

plat/arm/board/a5ds/include/platform_def.h

raw
1 /*
2 * Copyright (c) 2019-2024, Arm Limited. All rights reserved.
3 *
4 * SPDX-License-Identifier: BSD-3-Clause
5 */
6
7 #ifndef PLATFORM_DEF_H
8 #define PLATFORM_DEF_H
9
10 #include <common/tbbr/tbbr_img_def.h>
11 #include <lib/utils_def.h>
12 #include <lib/xlat_tables/xlat_tables_defs.h>
13 #include <plat/arm/board/common/v2m_def.h>
14 #include <plat/arm/common/smccc_def.h>
15 #include <plat/common/common_def.h>
16
17 /* Memory location options for TSP */
18 #define ARM_DRAM_ID 2
19
20 #define ARM_DRAM1_BASE UL(0x80000000)
21 #define ARM_DRAM1_SIZE UL(0x80000000)
22 #define ARM_DRAM1_END (ARM_DRAM1_BASE + \
23 ARM_DRAM1_SIZE - 1)
24
25 #define SRAM_BASE 0x2000000
26 #define SRAM_SIZE 0x200000
27
28 /* The first 4KB of NS DRAM1 are used as shared memory */
29 #define A5DS_SHARED_RAM_BASE SRAM_BASE
30 #define A5DS_SHARED_RAM_SIZE UL(0x00001000) /* 4 KB */
31
32 /* The next 252 kB of NS DRAM is used to load the BL images */
33 #define ARM_BL_RAM_BASE (A5DS_SHARED_RAM_BASE + \
34 A5DS_SHARED_RAM_SIZE)
35 #define ARM_BL_RAM_SIZE (PLAT_ARM_BL_PLUS_SHARED_RAM_SIZE - \
36 A5DS_SHARED_RAM_SIZE)
37
38 #define PERIPHBASE 0x1a000000
39 #define PERIPH_SIZE 0x00240000
40 #define A5_PERIPHERALS_BASE 0x1c000000
41 #define A5_PERIPHERALS_SIZE 0x10000
42
43 #define ARM_CACHE_WRITEBACK_SHIFT 5
44
45 #define ARM_IRQ_SEC_PHY_TIMER 29
46
47 #define ARM_IRQ_SEC_SGI_0 8
48 #define ARM_IRQ_SEC_SGI_1 9
49 #define ARM_IRQ_SEC_SGI_2 10
50 #define ARM_IRQ_SEC_SGI_3 11
51 #define ARM_IRQ_SEC_SGI_4 12
52 #define ARM_IRQ_SEC_SGI_5 13
53 #define ARM_IRQ_SEC_SGI_6 14
54 #define ARM_IRQ_SEC_SGI_7 15
55
56 /*
57 * Define a list of Group 1 Secure and Group 0 interrupt properties as per GICv3
58 * terminology. On a GICv2 system or mode, the lists will be merged and treated
59 * as Group 0 interrupts.
60 */
61 #define ARM_G1S_IRQ_PROPS(grp) \
62 INTR_PROP_DESC(ARM_IRQ_SEC_PHY_TIMER, GIC_HIGHEST_SEC_PRIORITY, (grp), \
63 GIC_INTR_CFG_LEVEL), \
64 INTR_PROP_DESC(ARM_IRQ_SEC_SGI_1, GIC_HIGHEST_SEC_PRIORITY, (grp), \
65 GIC_INTR_CFG_EDGE), \
66 INTR_PROP_DESC(ARM_IRQ_SEC_SGI_2, GIC_HIGHEST_SEC_PRIORITY, (grp), \
67 GIC_INTR_CFG_EDGE), \
68 INTR_PROP_DESC(ARM_IRQ_SEC_SGI_3, GIC_HIGHEST_SEC_PRIORITY, (grp), \
69 GIC_INTR_CFG_EDGE), \
70 INTR_PROP_DESC(ARM_IRQ_SEC_SGI_4, GIC_HIGHEST_SEC_PRIORITY, (grp), \
71 GIC_INTR_CFG_EDGE), \
72 INTR_PROP_DESC(ARM_IRQ_SEC_SGI_5, GIC_HIGHEST_SEC_PRIORITY, (grp), \
73 GIC_INTR_CFG_EDGE), \
74 INTR_PROP_DESC(ARM_IRQ_SEC_SGI_7, GIC_HIGHEST_SEC_PRIORITY, (grp), \
75 GIC_INTR_CFG_EDGE)
76
77 #define ARM_G0_IRQ_PROPS(grp) \
78 INTR_PROP_DESC(ARM_IRQ_SEC_SGI_6, GIC_HIGHEST_SEC_PRIORITY, (grp), \
79 GIC_INTR_CFG_EDGE)
80
81 #define A5DS_IRQ_TZ_WDOG 56
82 #define A5DS_IRQ_SEC_SYS_TIMER 57
83
84 /* Default cluster count for A5DS */
85 #define A5DS_CLUSTER_COUNT U(1)
86
87 /* Default number of CPUs per cluster on A5DS */
88 #define A5DS_MAX_CPUS_PER_CLUSTER U(4)
89
90 /* Default number of threads per CPU on A5DS */
91 #define A5DS_MAX_PE_PER_CPU U(1)
92
93 #define A5DS_CORE_COUNT U(4)
94
95 #define A5DS_PRIMARY_CPU 0x0
96
97 #define BOOT_BASE ARM_DRAM1_BASE
98 #define BOOT_SIZE UL(0x2800000)
99
100 #define ARM_NS_DRAM1_BASE (ARM_DRAM1_BASE + BOOT_SIZE)
101 /*
102 * The last 2MB is meant to be NOLOAD and will not be zero
103 * initialized.
104 */
105 #define ARM_NS_DRAM1_SIZE (ARM_DRAM1_SIZE - \
106 BOOT_SIZE - \
107 0x00200000)
108
109 #define MAP_BOOT_RW MAP_REGION_FLAT( \
110 BOOT_BASE, \
111 BOOT_SIZE, \
112 MT_DEVICE | MT_RW | MT_SECURE)
113
114 #define ARM_MAP_SHARED_RAM MAP_REGION_FLAT( \
115 A5DS_SHARED_RAM_BASE, \
116 A5DS_SHARED_RAM_SIZE, \
117 MT_MEMORY | MT_RW | MT_SECURE)
118
119 #define ARM_MAP_NS_DRAM1 MAP_REGION_FLAT( \
120 ARM_NS_DRAM1_BASE, \
121 ARM_NS_DRAM1_SIZE, \
122 MT_MEMORY | MT_RW | MT_NS)
123
124 #define ARM_MAP_SRAM MAP_REGION_FLAT( \
125 SRAM_BASE, \
126 SRAM_SIZE, \
127 MT_MEMORY | MT_RW | MT_NS)
128
129 /*
130 * Mapping for the BL1 RW region. This mapping is needed by BL2 in order to
131 * share the Mbed TLS heap. Since the heap is allocated inside BL1, it resides
132 * in the BL1 RW region. Hence, BL2 needs access to the BL1 RW region in order
133 * to be able to access the heap.
134 */
135
136 #define ARM_MAP_BL_RO MAP_REGION_FLAT(\
137 BL_CODE_BASE,\
138 BL_CODE_END - BL_CODE_BASE,\
139 MT_CODE | MT_SECURE),\
140 MAP_REGION_FLAT(\
141 BL_RO_DATA_BASE,\
142 BL_RO_DATA_END\
143 - BL_RO_DATA_BASE, \
144 MT_RO_DATA | MT_SECURE)
145
146 #if USE_COHERENT_MEM
147 #define ARM_MAP_BL_COHERENT_RAM MAP_REGION_FLAT(\
148 BL_COHERENT_RAM_BASE,\
149 BL_COHERENT_RAM_END \
150 - BL_COHERENT_RAM_BASE, \
151 MT_DEVICE | MT_RW | MT_SECURE)
152 #endif
153
154 /*
155 * Map the region for device tree configuration with read and write permissions
156 */
157 #define ARM_MAP_BL_CONFIG_REGION MAP_REGION_FLAT(ARM_BL_RAM_BASE, \
158 (ARM_FW_CONFIGS_LIMIT \
159 - ARM_BL_RAM_BASE), \
160 MT_MEMORY | MT_RW | MT_SECURE)
161
162 /*
163 * The max number of regions like RO(code), coherent and data required by
164 * different BL stages which need to be mapped in the MMU.
165 */
166 #define ARM_BL_REGIONS 6
167
168 #define MAX_MMAP_REGIONS (PLAT_ARM_MMAP_ENTRIES + \
169 ARM_BL_REGIONS)
170
171 /* Memory mapped Generic timer interfaces */
172 #define A5DS_TIMER_BASE_FREQUENCY UL(7500000)
173
174 #define ARM_CONSOLE_BAUDRATE 115200
175
176 #define PLAT_PHY_ADDR_SPACE_SIZE (1ULL << 32)
177 #define PLAT_VIRT_ADDR_SPACE_SIZE (1ULL << 32)
178
179 /*
180 * This macro defines the deepest retention state possible. A higher state
181 * id will represent an invalid or a power down state.
182 */
183 #define PLAT_MAX_RET_STATE 1
184
185 /*
186 * This macro defines the deepest power down states possible. Any state ID
187 * higher than this is invalid.
188 */
189 #define PLAT_MAX_OFF_STATE 2
190
191 /*
192 * Some data must be aligned on the biggest cache line size in the platform.
193 * This is known only to the platform as it might have a combination of
194 * integrated and external caches.
195 */
196 #define CACHE_WRITEBACK_GRANULE (U(1) << ARM_CACHE_WRITEBACK_SHIFT)
197
198 /*
199 * To enable FW_CONFIG to be loaded by BL1, define the corresponding base
200 * and limit. Leave enough space of BL2 meminfo.
201 */
202 #define ARM_FW_CONFIG_BASE (ARM_BL_RAM_BASE + sizeof(meminfo_t))
203 #define ARM_FW_CONFIG_LIMIT (ARM_BL_RAM_BASE + PAGE_SIZE)
204
205 /*
206 * Define limit of firmware configuration memory:
207 * ARM_FW_CONFIG + ARM_BL2_MEM_DESC memory
208 */
209 #define ARM_FW_CONFIGS_LIMIT (ARM_BL_RAM_BASE + (PAGE_SIZE * 2))
210
211 /* Define memory configuration for device tree files. */
212 #define PLAT_ARM_HW_CONFIG_SIZE U(0x01000000)
213
214 /*******************************************************************************
215 * BL1 specific defines.
216 * BL1 RW data is relocated from ROM to RAM at runtime so we need 2 sets of
217 * addresses.
218 ******************************************************************************/
219 #define BL1_RO_BASE 0x00000000
220 #define BL1_RO_LIMIT PLAT_ARM_TRUSTED_ROM_SIZE
221 /*
222 * Put BL1 RW at the top of the memory allocated for BL images in NS DRAM.
223 */
224 #define BL1_RW_BASE (ARM_BL_RAM_BASE + \
225 ARM_BL_RAM_SIZE - \
226 (PLAT_ARM_MAX_BL1_RW_SIZE))
227 #define BL1_RW_LIMIT (ARM_BL_RAM_BASE + \
228 (ARM_BL_RAM_SIZE))
229 /*******************************************************************************
230 * BL2 specific defines.
231 ******************************************************************************/
232
233 /*
234 * Put BL2 just below BL1.
235 */
236 #define BL2_BASE (BL1_RW_BASE - A5DS_MAX_BL2_SIZE)
237 #define BL2_LIMIT BL1_RW_BASE
238
239 /* Put BL32 below BL2 in NS DRAM.*/
240 #define ARM_BL2_MEM_DESC_BASE ARM_FW_CONFIG_LIMIT
241 #define ARM_BL2_MEM_DESC_LIMIT (ARM_BL2_MEM_DESC_BASE \
242 + (PAGE_SIZE / 2U))
243
244 #define BL32_BASE ((ARM_BL_RAM_BASE + ARM_BL_RAM_SIZE)\
245 - PLAT_ARM_MAX_BL32_SIZE)
246 #define BL32_PROGBITS_LIMIT BL2_BASE
247 #define BL32_LIMIT (ARM_BL_RAM_BASE + ARM_BL_RAM_SIZE)
248
249 /* Required platform porting definitions */
250 #define PLATFORM_CORE_COUNT A5DS_CORE_COUNT
251 #define PLAT_NUM_PWR_DOMAINS (A5DS_CLUSTER_COUNT + \
252 PLATFORM_CORE_COUNT) + U(1)
253
254 #define PLAT_MAX_PWR_LVL 2
255
256 /*
257 * Other platform porting definitions are provided by included headers
258 */
259
260 /*
261 * Required ARM standard platform porting definitions
262 */
263
264 #define PLAT_ARM_BL_PLUS_SHARED_RAM_SIZE 0x00040000 /* 256 KB */
265
266 #define PLAT_ARM_TRUSTED_ROM_BASE 0x00000000
267 #define PLAT_ARM_TRUSTED_ROM_SIZE 0x10000 /* 64KB */
268
269 #define PLAT_ARM_DRAM2_SIZE ULL(0x80000000)
270
271 /*
272 * Load address of BL33 for this platform port
273 */
274 #define PLAT_ARM_NS_IMAGE_BASE (ARM_DRAM1_BASE + U(0x8000000))
275
276 /*
277 * PLAT_ARM_MMAP_ENTRIES depends on the number of entries in the
278 * plat_arm_mmap array defined for each BL stage.
279 */
280 #if defined(IMAGE_BL32)
281 # define PLAT_ARM_MMAP_ENTRIES 8
282 # define MAX_XLAT_TABLES 6
283 #else
284 # define PLAT_ARM_MMAP_ENTRIES 12
285 # define MAX_XLAT_TABLES 6
286 #endif
287
288 /*
289 * PLAT_ARM_MAX_BL1_RW_SIZE is calculated using the current BL1 RW debug size
290 * plus a little space for growth.
291 */
292 #define PLAT_ARM_MAX_BL1_RW_SIZE 0xB000
293
294 /*
295 * A5DS_MAX_BL2_SIZE is calculated using the current BL2 debug size plus a
296 * little space for growth.
297 */
298 #define A5DS_MAX_BL2_SIZE 0x11000
299
300 /*
301 * Since BL32 NOBITS overlays BL2 and BL1-RW, PLAT_ARM_MAX_BL32_SIZE is
302 * calculated using the current SP_MIN PROGBITS debug size plus the sizes of
303 * BL2 and BL1-RW
304 */
305 #define PLAT_ARM_MAX_BL32_SIZE 0x3B000
306 /*
307 * Size of cacheable stacks
308 */
309 #if defined(IMAGE_BL1)
310 # define PLATFORM_STACK_SIZE 0x440
311 #elif defined(IMAGE_BL2)
312 # define PLATFORM_STACK_SIZE 0x400
313 #elif defined(IMAGE_BL32)
314 # define PLATFORM_STACK_SIZE 0x440
315 #endif
316
317 #define MAX_IO_DEVICES 3
318 #define MAX_IO_HANDLES 4
319
320 /* Reserve the last block of flash for PSCI MEM PROTECT flag */
321 #define PLAT_ARM_FLASH_IMAGE_BASE BOOT_BASE
322 #define PLAT_ARM_FLASH_IMAGE_MAX_SIZE (BOOT_SIZE - V2M_FLASH_BLOCK_SIZE)
323
324 #define PLAT_ARM_NVM_BASE BOOT_BASE
325 #define PLAT_ARM_NVM_SIZE (BOOT_SIZE - V2M_FLASH_BLOCK_SIZE)
326
327 /*
328 * PL011 related constants
329 */
330 #define PLAT_ARM_BOOT_UART_BASE 0x1A200000
331 #define PLAT_ARM_BOOT_UART_CLK_IN_HZ UL(7500000)
332
333 #define PLAT_ARM_RUN_UART_BASE 0x1A210000
334 #define PLAT_ARM_RUN_UART_CLK_IN_HZ UL(7500000)
335
336 #define PLAT_ARM_CRASH_UART_BASE PLAT_ARM_RUN_UART_BASE
337 #define PLAT_ARM_CRASH_UART_CLK_IN_HZ PLAT_ARM_RUN_UART_CLK_IN_HZ
338
339 #define A5DS_TIMER_BASE_FREQUENCY UL(7500000)
340
341 /* System timer related constants */
342 #define PLAT_ARM_NSTIMER_FRAME_ID 1
343
344 /* Mailbox base address */
345 #define A5DS_TRUSTED_MAILBOX_BASE A5DS_SHARED_RAM_BASE
346 #define A5DS_TRUSTED_MAILBOX_SIZE (8 + A5DS_HOLD_SIZE)
347 #define A5DS_HOLD_BASE (A5DS_TRUSTED_MAILBOX_BASE + 8)
348 #define A5DS_HOLD_SIZE (PLATFORM_CORE_COUNT * \
349 A5DS_HOLD_ENTRY_SIZE)
350 #define A5DS_HOLD_ENTRY_SHIFT 3
351 #define A5DS_HOLD_ENTRY_SIZE (1 << A5DS_HOLD_ENTRY_SHIFT)
352 #define A5DS_HOLD_STATE_WAIT 0
353 #define A5DS_HOLD_STATE_GO 1
354
355 /* Snoop Control Unit base address */
356 #define A5DS_SCU_BASE 0x1C000000
357
358 /*
359 * GIC related constants to cater for GICv2
360 */
361 #define PLAT_ARM_GICD_BASE 0x1C001000
362 #define PLAT_ARM_GICC_BASE 0x1C000100
363
364 /*
365 * Define a list of Group 1 Secure and Group 0 interrupts as per GICv3
366 * terminology. On a GICv2 system or mode, the lists will be merged and treated
367 * as Group 0 interrupts.
368 */
369 #define PLAT_ARM_G1S_IRQ_PROPS(grp) \
370 ARM_G1S_IRQ_PROPS(grp), \
371 INTR_PROP_DESC(A5DS_IRQ_TZ_WDOG, GIC_HIGHEST_SEC_PRIORITY, (grp), \
372 GIC_INTR_CFG_LEVEL), \
373 INTR_PROP_DESC(A5DS_IRQ_SEC_SYS_TIMER,\
374 GIC_HIGHEST_SEC_PRIORITY, (grp), \
375 GIC_INTR_CFG_LEVEL)
376
377 #define PLAT_ARM_G0_IRQ_PROPS(grp) ARM_G0_IRQ_PROPS(grp)
378
379 #endif /* PLATFORM_DEF_H */