blob: 6becf8086480e55d2f4d7804c34b39b18d94396b [file] [log] [blame]
Jeenu Viswambharan2fae4b12016-10-24 14:31:51 +01001#
Antonio Nino Diaz8855e522019-01-21 11:53:29 +00002# Copyright (c) 2016-2019, ARM Limited and Contributors. All rights reserved.
Jeenu Viswambharan2fae4b12016-10-24 14:31:51 +01003#
dp-arm82cb2c12017-05-03 09:38:09 +01004# SPDX-License-Identifier: BSD-3-Clause
Jeenu Viswambharan2fae4b12016-10-24 14:31:51 +01005#
6
7# Default, static values for build variables, listed in alphabetic order.
8# Dependencies between build options, if any, are handled in the top-level
9# Makefile, after this file is included. This ensures that the former is better
10# poised to handle dependencies, as all build variables would have a default
11# value by then.
12
Antonio Nino Diaz8fd9d4d2018-08-08 16:28:43 +010013# Use T32 by default
14AARCH32_INSTRUCTION_SET := T32
15
Jeenu Viswambharan2fae4b12016-10-24 14:31:51 +010016# The AArch32 Secure Payload to be built as BL32 image
17AARCH32_SP := none
18
19# The Target build architecture. Supported values are: aarch64, aarch32.
20ARCH := aarch64
21
Jeenu Viswambharanc877b412017-01-16 16:52:35 +000022# ARM Architecture major and minor versions: 8.0 by default.
23ARM_ARCH_MAJOR := 8
24ARM_ARCH_MINOR := 0
25
Jeenu Viswambharan2fae4b12016-10-24 14:31:51 +010026# Base commit to perform code check on
27BASE_COMMIT := origin/master
28
Roberto Vargasb1d27b42017-10-30 14:43:43 +000029# Execute BL2 at EL3
30BL2_AT_EL3 := 0
31
Jiafei Pan7d173fc2018-03-21 07:20:09 +000032# BL2 image is stored in XIP memory, for now, this option is only supported
33# when BL2_AT_EL3 is 1.
34BL2_IN_XIP_MEM := 0
35
Alexei Fedorov9fc59632019-05-24 12:17:09 +010036# Select the branch protection features to use.
37BRANCH_PROTECTION := 0
38
Jeenu Viswambharan2fae4b12016-10-24 14:31:51 +010039# By default, consider that the platform may release several CPUs out of reset.
40# The platform Makefile is free to override this value.
41COLD_BOOT_SINGLE_CPU := 0
42
Julius Werner3429c772017-06-09 15:17:15 -070043# Flag to compile in coreboot support code. Exclude by default. The coreboot
44# Makefile system will set this when compiling TF as part of a coreboot image.
45COREBOOT := 0
46
Jeenu Viswambharan2fae4b12016-10-24 14:31:51 +010047# For Chain of Trust
48CREATE_KEYS := 1
49
50# Build flag to include AArch32 registers in cpu context save and restore during
51# world switch. This flag must be set to 0 for AArch64-only platforms.
52CTX_INCLUDE_AARCH32_REGS := 1
53
54# Include FP registers in cpu context
55CTX_INCLUDE_FPREGS := 0
56
Antonio Nino Diaz52839622019-01-31 11:58:00 +000057# Include pointer authentication (ARMv8.3-PAuth) registers in cpu context. This
58# must be set to 1 if the platform wants to use this feature in the Secure
59# world. It is not needed to use it in the Non-secure world.
60CTX_INCLUDE_PAUTH_REGS := 0
61
Jeenu Viswambharan2fae4b12016-10-24 14:31:51 +010062# Debug build
63DEBUG := 0
64
65# Build platform
66DEFAULT_PLAT := fvp
67
Christoph Müllner9e4609f2019-04-24 09:45:30 +020068# Disable the generation of the binary image (ELF only).
69DISABLE_BIN_GENERATION := 0
70
Soby Mathew209a60c2018-03-26 12:43:37 +010071# Enable capability to disable authentication dynamically. Only meant for
72# development platforms.
73DYN_DISABLE_AUTH := 0
74
Jeenu Viswambharan5f835912018-07-31 16:13:33 +010075# Build option to enable MPAM for lower ELs
76ENABLE_MPAM_FOR_LOWER_ELS := 0
77
Soby Mathew3bd17c02018-08-28 11:13:55 +010078# Flag to Enable Position Independant support (PIE)
79ENABLE_PIE := 0
80
Jeenu Viswambharan2fae4b12016-10-24 14:31:51 +010081# Flag to enable Performance Measurement Framework
82ENABLE_PMF := 0
83
84# Flag to enable PSCI STATs functionality
85ENABLE_PSCI_STAT := 0
86
87# Flag to enable runtime instrumentation using PMF
88ENABLE_RUNTIME_INSTRUMENTATION := 0
89
Douglas Raillard51faada2017-02-24 18:14:15 +000090# Flag to enable stack corruption protection
91ENABLE_STACK_PROTECTOR := 0
92
Jeenu Viswambharan21b818c2017-09-22 08:32:10 +010093# Flag to enable exception handling in EL3
94EL3_EXCEPTION_HANDLING := 0
95
Alexei Fedorov9fc59632019-05-24 12:17:09 +010096# Flag to enable Branch Target Identification.
97# Internal flag not meant for direct setting.
98# Use BRANCH_PROTECTION to enable BTI.
99ENABLE_BTI := 0
100
101# Flag to enable Pointer Authentication.
102# Internal flag not meant for direct setting.
103# Use BRANCH_PROTECTION to enable PAUTH.
Antonio Nino Diazb86048c2019-02-19 11:53:51 +0000104ENABLE_PAUTH := 0
105
Jeenu Viswambharan2fae4b12016-10-24 14:31:51 +0100106# Build flag to treat usage of deprecated platform and framework APIs as error.
107ERROR_DEPRECATED := 0
108
Jeenu Viswambharan1a7c1cf2017-12-08 12:13:51 +0000109# Fault injection support
110FAULT_INJECTION_SUPPORT := 0
111
Masahiro Yamada1c75d5d2016-12-25 13:52:22 +0900112# Byte alignment that each component in FIP is aligned to
113FIP_ALIGN := 0
114
Jeenu Viswambharan2fae4b12016-10-24 14:31:51 +0100115# Default FIP file name
116FIP_NAME := fip.bin
117
118# Default FWU_FIP file name
119FWU_FIP_NAME := fwu_fip.bin
120
121# For Chain of Trust
122GENERATE_COT := 0
123
Jeenu Viswambharan74dce7f2017-09-22 08:32:09 +0100124# Hint platform interrupt control layer that Group 0 interrupts are for EL3. By
125# default, they are for Secure EL1.
126GICV2_G0_FOR_EL3 := 0
127
Jeenu Viswambharan76454ab2017-11-30 12:54:15 +0000128# Route External Aborts to EL3. Disabled by default; External Aborts are handled
129# by lower ELs.
130HANDLE_EA_EL3_FIRST := 0
131
Jeenu Viswambharan3c251af2017-01-04 13:51:42 +0000132# Whether system coherency is managed in hardware, without explicit software
133# operations.
134HW_ASSISTED_COHERENCY := 0
135
Soby Mathew20917552017-08-31 11:49:32 +0100136# Set the default algorithm for the generation of Trusted Board Boot keys
137KEY_ALG := rsa
138
Dan Handleybc1a03c2018-02-27 16:03:58 +0000139# Enable use of the console API allowing multiple consoles to be registered
140# at the same time.
141MULTI_CONSOLE_API := 0
Julius Werner9536bae2017-07-31 18:15:11 -0700142
Jeenu Viswambharan2fae4b12016-10-24 14:31:51 +0100143# NS timer register save and restore
144NS_TIMER_SWITCH := 0
145
Varun Wadekar77f1f7a2019-01-31 09:22:30 -0800146# Include lib/libc in the final image
147OVERRIDE_LIBC := 0
148
Jeenu Viswambharan2fae4b12016-10-24 14:31:51 +0100149# Build PL011 UART driver in minimal generic UART mode
150PL011_GENERIC_UART := 0
151
152# By default, consider that the platform's reset address is not programmable.
153# The platform Makefile is free to override this value.
154PROGRAMMABLE_RESET_ADDRESS := 0
155
Antonio Nino Diaz73308612019-02-28 13:35:21 +0000156# Flag used to choose the power state format: Extended State-ID or Original
Jeenu Viswambharan2fae4b12016-10-24 14:31:51 +0100157PSCI_EXTENDED_STATE_ID := 0
158
Jeenu Viswambharan14c60162018-04-04 16:07:11 +0100159# Enable RAS support
160RAS_EXTENSION := 0
161
Jeenu Viswambharan2fae4b12016-10-24 14:31:51 +0100162# By default, BL1 acts as the reset handler, not BL31
163RESET_TO_BL31 := 0
164
165# For Chain of Trust
166SAVE_KEYS := 0
167
Jeenu Viswambharanb7cb1332017-10-16 08:43:14 +0100168# Software Delegated Exception support
169SDEI_SUPPORT := 0
170
Jeenu Viswambharan2fae4b12016-10-24 14:31:51 +0100171# Whether code and read-only data should be put on separate memory pages. The
172# platform Makefile is free to override this value.
173SEPARATE_CODE_AND_RODATA := 0
174
Daniel Boulby1dcc28c2018-09-18 11:45:51 +0100175# If the BL31 image initialisation code is recalimed after use for the secondary
176# cores stack
177RECLAIM_INIT_CODE := 0
178
Jeenu Viswambharan2fae4b12016-10-24 14:31:51 +0100179# SPD choice
180SPD := none
181
Antonio Nino Diaz2fccb222017-10-24 10:07:35 +0100182# For including the Secure Partition Manager
183ENABLE_SPM := 0
184
Antonio Nino Diaz8855e522019-01-21 11:53:29 +0000185# Use the SPM based on MM
186SPM_MM := 1
Antonio Nino Diaz2d7b9e52018-10-30 11:08:08 +0000187
Jeenu Viswambharan2fae4b12016-10-24 14:31:51 +0100188# Flag to introduce an infinite loop in BL1 just before it exits into the next
189# image. This is meant to help debugging the post-BL2 phase.
190SPIN_ON_BL1_EXIT := 0
191
192# Flags to build TF with Trusted Boot support
193TRUSTED_BOARD_BOOT := 0
194
Antonio Nino Diaze23e0572018-09-25 09:41:08 +0100195# Build option to choose whether Trusted Firmware uses Coherent memory or not.
Jeenu Viswambharan2fae4b12016-10-24 14:31:51 +0100196USE_COHERENT_MEM := 1
197
Antonio Nino Diaze23e0572018-09-25 09:41:08 +0100198# Build option to choose whether Trusted Firmware uses library at ROM
199USE_ROMLIB := 0
Roberto Vargas5accce52018-05-22 16:05:42 +0100200
Masahiro Yamadabb41eb72017-05-22 12:11:24 +0900201# Use tbbr_oid.h instead of platform_oid.h
Antonio Nino Diaze23e0572018-09-25 09:41:08 +0100202USE_TBBR_DEFS := 1
Masahiro Yamadabb41eb72017-05-22 12:11:24 +0900203
Jeenu Viswambharan2fae4b12016-10-24 14:31:51 +0100204# Build verbosity
205V := 0
Soby Mathewbcc3c492017-04-10 22:35:42 +0100206
207# Whether to enable D-Cache early during warm boot. This is usually
208# applicable for platforms wherein interconnect programming is not
209# required to enable cache coherency after warm reset (eg: single cluster
210# platforms).
211WARMBOOT_ENABLE_DCACHE_EARLY := 0
dp-armd832aee2017-05-23 09:32:49 +0100212
Dimitris Papastamosc776dee2017-10-13 15:07:45 +0100213# Build option to enable/disable the Statistical Profiling Extensions
dp-armd832aee2017-05-23 09:32:49 +0100214ENABLE_SPE_FOR_LOWER_ELS := 1
215
Dimitris Papastamosc776dee2017-10-13 15:07:45 +0100216# SPE is only supported on AArch64 so disable it on AArch32.
dp-armd832aee2017-05-23 09:32:49 +0100217ifeq (${ARCH},aarch32)
218 override ENABLE_SPE_FOR_LOWER_ELS := 0
dp-armd832aee2017-05-23 09:32:49 +0100219endif
Dimitris Papastamos0319a972017-10-16 11:40:10 +0100220
221ENABLE_AMU := 0
David Cunado1a853372017-10-20 11:30:57 +0100222
223# By default, enable Scalable Vector Extension if implemented for Non-secure
224# lower ELs
225# Note SVE is only supported on AArch64 - therefore do not enable in AArch32
226ifneq (${ARCH},aarch32)
227 ENABLE_SVE_FOR_NS := 1
228else
229 override ENABLE_SVE_FOR_NS := 0
230endif