xref: /rk3399_ARM-atf/make_helpers/defaults.mk (revision 062f8aaf8a415497191f991a744fc7901362ba3c)
12fae4b1eSJeenu Viswambharan#
2ae3cf1ffSAlexei Fedorov# Copyright (c) 2016-2020, ARM Limited. All rights reserved.
32fae4b1eSJeenu Viswambharan#
482cb2c1aSdp-arm# SPDX-License-Identifier: BSD-3-Clause
52fae4b1eSJeenu Viswambharan#
62fae4b1eSJeenu Viswambharan
72fae4b1eSJeenu Viswambharan# Default, static values for build variables, listed in alphabetic order.
82fae4b1eSJeenu Viswambharan# Dependencies between build options, if any, are handled in the top-level
92fae4b1eSJeenu Viswambharan# Makefile, after this file is included. This ensures that the former is better
102fae4b1eSJeenu Viswambharan# poised to handle dependencies, as all build variables would have a default
112fae4b1eSJeenu Viswambharan# value by then.
122fae4b1eSJeenu Viswambharan
138fd9d4d5SAntonio Nino Diaz# Use T32 by default
148fd9d4d5SAntonio Nino DiazAARCH32_INSTRUCTION_SET		:= T32
158fd9d4d5SAntonio Nino Diaz
162fae4b1eSJeenu Viswambharan# The AArch32 Secure Payload to be built as BL32 image
172fae4b1eSJeenu ViswambharanAARCH32_SP			:= none
182fae4b1eSJeenu Viswambharan
192fae4b1eSJeenu Viswambharan# The Target build architecture. Supported values are: aarch64, aarch32.
202fae4b1eSJeenu ViswambharanARCH				:= aarch64
212fae4b1eSJeenu Viswambharan
22c877b414SJeenu Viswambharan# ARM Architecture major and minor versions: 8.0 by default.
23c877b414SJeenu ViswambharanARM_ARCH_MAJOR			:= 8
24c877b414SJeenu ViswambharanARM_ARCH_MINOR			:= 0
25c877b414SJeenu Viswambharan
262fae4b1eSJeenu Viswambharan# Base commit to perform code check on
272fae4b1eSJeenu ViswambharanBASE_COMMIT			:= origin/master
282fae4b1eSJeenu Viswambharan
29b1d27b48SRoberto Vargas# Execute BL2 at EL3
30b1d27b48SRoberto VargasBL2_AT_EL3			:= 0
31b1d27b48SRoberto Vargas
327d173fc5SJiafei Pan# BL2 image is stored in XIP memory, for now, this option is only supported
337d173fc5SJiafei Pan# when BL2_AT_EL3 is 1.
347d173fc5SJiafei PanBL2_IN_XIP_MEM			:= 0
357d173fc5SJiafei Pan
36b90f207aSHadi Asyrafi# Do dcache invalidate upon BL2 entry at EL3
37b90f207aSHadi AsyrafiBL2_INV_DCACHE			:= 1
38b90f207aSHadi Asyrafi
399fc59639SAlexei Fedorov# Select the branch protection features to use.
409fc59639SAlexei FedorovBRANCH_PROTECTION		:= 0
419fc59639SAlexei Fedorov
422fae4b1eSJeenu Viswambharan# By default, consider that the platform may release several CPUs out of reset.
432fae4b1eSJeenu Viswambharan# The platform Makefile is free to override this value.
442fae4b1eSJeenu ViswambharanCOLD_BOOT_SINGLE_CPU		:= 0
452fae4b1eSJeenu Viswambharan
463429c77aSJulius Werner# Flag to compile in coreboot support code. Exclude by default. The coreboot
473429c77aSJulius Werner# Makefile system will set this when compiling TF as part of a coreboot image.
483429c77aSJulius WernerCOREBOOT			:= 0
493429c77aSJulius Werner
502fae4b1eSJeenu Viswambharan# For Chain of Trust
512fae4b1eSJeenu ViswambharanCREATE_KEYS			:= 1
522fae4b1eSJeenu Viswambharan
532fae4b1eSJeenu Viswambharan# Build flag to include AArch32 registers in cpu context save and restore during
542fae4b1eSJeenu Viswambharan# world switch. This flag must be set to 0 for AArch64-only platforms.
552fae4b1eSJeenu ViswambharanCTX_INCLUDE_AARCH32_REGS	:= 1
562fae4b1eSJeenu Viswambharan
572fae4b1eSJeenu Viswambharan# Include FP registers in cpu context
582fae4b1eSJeenu ViswambharanCTX_INCLUDE_FPREGS		:= 0
592fae4b1eSJeenu Viswambharan
605283962eSAntonio Nino Diaz# Include pointer authentication (ARMv8.3-PAuth) registers in cpu context. This
615283962eSAntonio Nino Diaz# must be set to 1 if the platform wants to use this feature in the Secure
625283962eSAntonio Nino Diaz# world. It is not needed to use it in the Non-secure world.
635283962eSAntonio Nino DiazCTX_INCLUDE_PAUTH_REGS		:= 0
645283962eSAntonio Nino Diaz
65*062f8aafSArunachalam Ganapathy# Include Nested virtualization control (Armv8.4-NV) registers in cpu context.
66*062f8aafSArunachalam Ganapathy# This must be set to 1 if architecture implements Nested Virtualization
67*062f8aafSArunachalam Ganapathy# Extension and platform wants to use this feature in the Secure world
68*062f8aafSArunachalam GanapathyCTX_INCLUDE_NEVE_REGS		:= 0
69*062f8aafSArunachalam Ganapathy
702fae4b1eSJeenu Viswambharan# Debug build
712fae4b1eSJeenu ViswambharanDEBUG				:= 0
722fae4b1eSJeenu Viswambharan
737cda17bbSSumit Garg# By default disable authenticated decryption support.
747cda17bbSSumit GargDECRYPTION_SUPPORT		:= none
757cda17bbSSumit Garg
762fae4b1eSJeenu Viswambharan# Build platform
772fae4b1eSJeenu ViswambharanDEFAULT_PLAT			:= fvp
782fae4b1eSJeenu Viswambharan
799e4609f1SChristoph Müllner# Disable the generation of the binary image (ELF only).
809e4609f1SChristoph MüllnerDISABLE_BIN_GENERATION		:= 0
819e4609f1SChristoph Müllner
82209a60ccSSoby Mathew# Enable capability to disable authentication dynamically. Only meant for
83209a60ccSSoby Mathew# development platforms.
84209a60ccSSoby MathewDYN_DISABLE_AUTH		:= 0
85209a60ccSSoby Mathew
865f835918SJeenu Viswambharan# Build option to enable MPAM for lower ELs
875f835918SJeenu ViswambharanENABLE_MPAM_FOR_LOWER_ELS	:= 0
885f835918SJeenu Viswambharan
893bd17c0fSSoby Mathew# Flag to Enable Position Independant support (PIE)
903bd17c0fSSoby MathewENABLE_PIE			:= 0
913bd17c0fSSoby Mathew
922fae4b1eSJeenu Viswambharan# Flag to enable Performance Measurement Framework
932fae4b1eSJeenu ViswambharanENABLE_PMF			:= 0
942fae4b1eSJeenu Viswambharan
952fae4b1eSJeenu Viswambharan# Flag to enable PSCI STATs functionality
962fae4b1eSJeenu ViswambharanENABLE_PSCI_STAT		:= 0
972fae4b1eSJeenu Viswambharan
982fae4b1eSJeenu Viswambharan# Flag to enable runtime instrumentation using PMF
992fae4b1eSJeenu ViswambharanENABLE_RUNTIME_INSTRUMENTATION	:= 0
1002fae4b1eSJeenu Viswambharan
10151faada7SDouglas Raillard# Flag to enable stack corruption protection
10251faada7SDouglas RaillardENABLE_STACK_PROTECTOR		:= 0
10351faada7SDouglas Raillard
10421b818c0SJeenu Viswambharan# Flag to enable exception handling in EL3
10521b818c0SJeenu ViswambharanEL3_EXCEPTION_HANDLING		:= 0
10621b818c0SJeenu Viswambharan
1079fc59639SAlexei Fedorov# Flag to enable Branch Target Identification.
1089fc59639SAlexei Fedorov# Internal flag not meant for direct setting.
1099fc59639SAlexei Fedorov# Use BRANCH_PROTECTION to enable BTI.
1109fc59639SAlexei FedorovENABLE_BTI			:= 0
1119fc59639SAlexei Fedorov
1129fc59639SAlexei Fedorov# Flag to enable Pointer Authentication.
1139fc59639SAlexei Fedorov# Internal flag not meant for direct setting.
1149fc59639SAlexei Fedorov# Use BRANCH_PROTECTION to enable PAUTH.
115b86048c4SAntonio Nino DiazENABLE_PAUTH			:= 0
116b86048c4SAntonio Nino Diaz
117c6ba9b45SSumit Garg# By default BL31 encryption disabled
118c6ba9b45SSumit GargENCRYPT_BL31			:= 0
119c6ba9b45SSumit Garg
120c6ba9b45SSumit Garg# By default BL32 encryption disabled
121c6ba9b45SSumit GargENCRYPT_BL32			:= 0
122c6ba9b45SSumit Garg
123c6ba9b45SSumit Garg# Default dummy firmware encryption key
124c6ba9b45SSumit GargENC_KEY	:= 1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef
125c6ba9b45SSumit Garg
126c6ba9b45SSumit Garg# Default dummy nonce for firmware encryption
127c6ba9b45SSumit GargENC_NONCE			:= 1234567890abcdef12345678
128c6ba9b45SSumit Garg
1292fae4b1eSJeenu Viswambharan# Build flag to treat usage of deprecated platform and framework APIs as error.
1302fae4b1eSJeenu ViswambharanERROR_DEPRECATED		:= 0
1312fae4b1eSJeenu Viswambharan
1321a7c1cfeSJeenu Viswambharan# Fault injection support
1331a7c1cfeSJeenu ViswambharanFAULT_INJECTION_SUPPORT		:= 0
1341a7c1cfeSJeenu Viswambharan
1351c75d5dfSMasahiro Yamada# Byte alignment that each component in FIP is aligned to
1361c75d5dfSMasahiro YamadaFIP_ALIGN			:= 0
1371c75d5dfSMasahiro Yamada
1382fae4b1eSJeenu Viswambharan# Default FIP file name
1392fae4b1eSJeenu ViswambharanFIP_NAME			:= fip.bin
1402fae4b1eSJeenu Viswambharan
1412fae4b1eSJeenu Viswambharan# Default FWU_FIP file name
1422fae4b1eSJeenu ViswambharanFWU_FIP_NAME			:= fwu_fip.bin
1432fae4b1eSJeenu Viswambharan
144c6ba9b45SSumit Garg# By default firmware encryption with SSK
145c6ba9b45SSumit GargFW_ENC_STATUS			:= 0
146c6ba9b45SSumit Garg
1472fae4b1eSJeenu Viswambharan# For Chain of Trust
1482fae4b1eSJeenu ViswambharanGENERATE_COT			:= 0
1492fae4b1eSJeenu Viswambharan
15074dce7faSJeenu Viswambharan# Hint platform interrupt control layer that Group 0 interrupts are for EL3. By
15174dce7faSJeenu Viswambharan# default, they are for Secure EL1.
15274dce7faSJeenu ViswambharanGICV2_G0_FOR_EL3		:= 0
15374dce7faSJeenu Viswambharan
15476454abfSJeenu Viswambharan# Route External Aborts to EL3. Disabled by default; External Aborts are handled
15576454abfSJeenu Viswambharan# by lower ELs.
15676454abfSJeenu ViswambharanHANDLE_EA_EL3_FIRST		:= 0
15776454abfSJeenu Viswambharan
158ae3cf1ffSAlexei Fedorov# Secure hash algorithm flag, accepts 3 values: sha256, sha384 and sha512.
159ae3cf1ffSAlexei Fedorov# The default value is sha256.
160ae3cf1ffSAlexei FedorovHASH_ALG			:= sha256
161ae3cf1ffSAlexei Fedorov
1623c251af3SJeenu Viswambharan# Whether system coherency is managed in hardware, without explicit software
1633c251af3SJeenu Viswambharan# operations.
1643c251af3SJeenu ViswambharanHW_ASSISTED_COHERENCY		:= 0
1653c251af3SJeenu Viswambharan
1662091755cSSoby Mathew# Set the default algorithm for the generation of Trusted Board Boot keys
1672091755cSSoby MathewKEY_ALG				:= rsa
1682091755cSSoby Mathew
169ee15a172SLeonardo Sandoval# Set the default key size in case KEY_ALG is rsa
170ee15a172SLeonardo Sandovalifeq ($(KEY_ALG),rsa)
171ee15a172SLeonardo SandovalKEY_SIZE			:= 2048
172ee15a172SLeonardo Sandovalendif
173ee15a172SLeonardo Sandoval
1748c105290SAlexei Fedorov# Option to build TF with Measured Boot support
1758c105290SAlexei FedorovMEASURED_BOOT			:= 0
1768c105290SAlexei Fedorov
1772fae4b1eSJeenu Viswambharan# NS timer register save and restore
1782fae4b1eSJeenu ViswambharanNS_TIMER_SWITCH			:= 0
1792fae4b1eSJeenu Viswambharan
18077f1f7a1SVarun Wadekar# Include lib/libc in the final image
18177f1f7a1SVarun WadekarOVERRIDE_LIBC			:= 0
18277f1f7a1SVarun Wadekar
1832fae4b1eSJeenu Viswambharan# Build PL011 UART driver in minimal generic UART mode
1842fae4b1eSJeenu ViswambharanPL011_GENERIC_UART		:= 0
1852fae4b1eSJeenu Viswambharan
1862fae4b1eSJeenu Viswambharan# By default, consider that the platform's reset address is not programmable.
1872fae4b1eSJeenu Viswambharan# The platform Makefile is free to override this value.
1882fae4b1eSJeenu ViswambharanPROGRAMMABLE_RESET_ADDRESS	:= 0
1892fae4b1eSJeenu Viswambharan
19073308618SAntonio Nino Diaz# Flag used to choose the power state format: Extended State-ID or Original
1912fae4b1eSJeenu ViswambharanPSCI_EXTENDED_STATE_ID		:= 0
1922fae4b1eSJeenu Viswambharan
19314c6016aSJeenu Viswambharan# Enable RAS support
19414c6016aSJeenu ViswambharanRAS_EXTENSION			:= 0
19514c6016aSJeenu Viswambharan
1962fae4b1eSJeenu Viswambharan# By default, BL1 acts as the reset handler, not BL31
1972fae4b1eSJeenu ViswambharanRESET_TO_BL31			:= 0
1982fae4b1eSJeenu Viswambharan
1992fae4b1eSJeenu Viswambharan# For Chain of Trust
2002fae4b1eSJeenu ViswambharanSAVE_KEYS			:= 0
2012fae4b1eSJeenu Viswambharan
202b7cb133eSJeenu Viswambharan# Software Delegated Exception support
203b7cb133eSJeenu ViswambharanSDEI_SUPPORT            	:= 0
204b7cb133eSJeenu Viswambharan
2052fae4b1eSJeenu Viswambharan# Whether code and read-only data should be put on separate memory pages. The
2062fae4b1eSJeenu Viswambharan# platform Makefile is free to override this value.
2072fae4b1eSJeenu ViswambharanSEPARATE_CODE_AND_RODATA	:= 0
2082fae4b1eSJeenu Viswambharan
209f8578e64SSamuel Holland# Put NOBITS sections (.bss, stacks, page tables, and coherent memory) in a
210f8578e64SSamuel Holland# separate memory region, which may be discontiguous from the rest of BL31.
211f8578e64SSamuel HollandSEPARATE_NOBITS_REGION		:= 0
212f8578e64SSamuel Holland
2131dcc28cfSDaniel Boulby# If the BL31 image initialisation code is recalimed after use for the secondary
2141dcc28cfSDaniel Boulby# cores stack
2151dcc28cfSDaniel BoulbyRECLAIM_INIT_CODE		:= 0
2161dcc28cfSDaniel Boulby
2172fae4b1eSJeenu Viswambharan# SPD choice
2182fae4b1eSJeenu ViswambharanSPD				:= none
2192fae4b1eSJeenu Viswambharan
2203f3c341aSPaul Beesley# Enable the Management Mode (MM)-based Secure Partition Manager implementation
2213f3c341aSPaul BeesleySPM_MM				:= 0
2222d7b9e5eSAntonio Nino Diaz
223033039f8SMax Shvetsov# Use SPM at S-EL2 as a default config for SPMD
224033039f8SMax ShvetsovSPMD_SPM_AT_SEL2		:= 1
225033039f8SMax Shvetsov
2262fae4b1eSJeenu Viswambharan# Flag to introduce an infinite loop in BL1 just before it exits into the next
2272fae4b1eSJeenu Viswambharan# image. This is meant to help debugging the post-BL2 phase.
2282fae4b1eSJeenu ViswambharanSPIN_ON_BL1_EXIT		:= 0
2292fae4b1eSJeenu Viswambharan
2302fae4b1eSJeenu Viswambharan# Flags to build TF with Trusted Boot support
2312fae4b1eSJeenu ViswambharanTRUSTED_BOARD_BOOT		:= 0
2322fae4b1eSJeenu Viswambharan
233e23e057eSAntonio Nino Diaz# Build option to choose whether Trusted Firmware uses Coherent memory or not.
2342fae4b1eSJeenu ViswambharanUSE_COHERENT_MEM		:= 1
2352fae4b1eSJeenu Viswambharan
2360ca3913dSOlivier Deprez# Build option to add debugfs support
2370ca3913dSOlivier DeprezUSE_DEBUGFS			:= 0
2380ca3913dSOlivier Deprez
2390a6e7e3bSLouis Mayencourt# Build option to fconf based io
240a6de824fSLouis MayencourtARM_IO_IN_DTB			:= 0
241cbf9e84aSBalint Dobszay
242cbf9e84aSBalint Dobszay# Build option to support SDEI through fconf
243cbf9e84aSBalint DobszaySDEI_IN_FCONF			:= 0
244452d5e5eSMadhukar Pappireddy
245452d5e5eSMadhukar Pappireddy# Build option to support Secure Interrupt descriptors through fconf
246452d5e5eSMadhukar PappireddySEC_INT_DESC_IN_FCONF		:= 0
2470a6e7e3bSLouis Mayencourt
248e23e057eSAntonio Nino Diaz# Build option to choose whether Trusted Firmware uses library at ROM
2495accce5bSRoberto VargasUSE_ROMLIB			:= 0
2505accce5bSRoberto Vargas
25160e8f3cfSPetre-Ionut Tudor# Build option to choose whether the xlat tables of BL images can be read-only.
25260e8f3cfSPetre-Ionut Tudor# Note that this only serves as a higher level option to PLAT_RO_XLAT_TABLES,
25360e8f3cfSPetre-Ionut Tudor# which is the per BL-image option that actually enables the read-only tables
25460e8f3cfSPetre-Ionut Tudor# API. The reason for having this additional option is to have a common high
25560e8f3cfSPetre-Ionut Tudor# level makefile where we can check for incompatible features/build options.
25660e8f3cfSPetre-Ionut TudorALLOW_RO_XLAT_TABLES		:= 0
25760e8f3cfSPetre-Ionut Tudor
2583bff910dSSandrine Bailleux# Chain of trust.
2593bff910dSSandrine BailleuxCOT				:= tbbr
2603bff910dSSandrine Bailleux
261bb41eb7aSMasahiro Yamada# Use tbbr_oid.h instead of platform_oid.h
262e23e057eSAntonio Nino DiazUSE_TBBR_DEFS			:= 1
263bb41eb7aSMasahiro Yamada
2642fae4b1eSJeenu Viswambharan# Build verbosity
2652fae4b1eSJeenu ViswambharanV				:= 0
266bcc3c49cSSoby Mathew
267bcc3c49cSSoby Mathew# Whether to enable D-Cache early during warm boot. This is usually
268bcc3c49cSSoby Mathew# applicable for platforms wherein interconnect programming is not
269bcc3c49cSSoby Mathew# required to enable cache coherency after warm reset (eg: single cluster
270bcc3c49cSSoby Mathew# platforms).
271bcc3c49cSSoby MathewWARMBOOT_ENABLE_DCACHE_EARLY	:= 0
272d832aee9Sdp-arm
273c776deedSDimitris Papastamos# Build option to enable/disable the Statistical Profiling Extensions
274d832aee9Sdp-armENABLE_SPE_FOR_LOWER_ELS	:= 1
275d832aee9Sdp-arm
276c776deedSDimitris Papastamos# SPE is only supported on AArch64 so disable it on AArch32.
277d832aee9Sdp-armifeq (${ARCH},aarch32)
278d832aee9Sdp-arm    override ENABLE_SPE_FOR_LOWER_ELS := 0
279d832aee9Sdp-armendif
2800319a977SDimitris Papastamos
2819dd94382SJustin Chadwell# Include Memory Tagging Extension registers in cpu context. This must be set
2829dd94382SJustin Chadwell# to 1 if the platform wants to use this feature in the Secure world and MTE is
2839dd94382SJustin Chadwell# enabled at ELX.
2849dd94382SJustin ChadwellCTX_INCLUDE_MTE_REGS := 0
2859dd94382SJustin Chadwell
2860319a977SDimitris PapastamosENABLE_AMU			:= 0
2871a853370SDavid Cunado
2881a853370SDavid Cunado# By default, enable Scalable Vector Extension if implemented for Non-secure
2891a853370SDavid Cunado# lower ELs
2901a853370SDavid Cunado# Note SVE is only supported on AArch64 - therefore do not enable in AArch32
2911a853370SDavid Cunadoifneq (${ARCH},aarch32)
2921a853370SDavid Cunado    ENABLE_SVE_FOR_NS		:= 1
2931a853370SDavid Cunadoelse
2941a853370SDavid Cunado    override ENABLE_SVE_FOR_NS	:= 0
2951a853370SDavid Cunadoendif
2961f461979SJustin Chadwell
2971f461979SJustin ChadwellSANITIZE_UB := off
298c97cba4eSSoby Mathew
299c97cba4eSSoby Mathew# For ARMv8.1 (AArch64) platforms, enabling this option selects the spinlock
300c97cba4eSSoby Mathew# implementation variant using the ARMv8.1-LSE compare-and-swap instruction.
301c97cba4eSSoby Mathew# Default: disabled
302c97cba4eSSoby MathewUSE_SPINLOCK_CAS := 0
303edbce9aaSzelalem-aweke
304edbce9aaSzelalem-aweke# Enable Link Time Optimization
305edbce9aaSzelalem-awekeENABLE_LTO			:= 0
30628f39f02SMax Shvetsov
30728f39f02SMax Shvetsov# Build flag to include EL2 registers in cpu context save and restore during
30828f39f02SMax Shvetsov# S-EL2 firmware entry/exit. This flag is to be used with SPD=spmd option.
30928f39f02SMax Shvetsov# Default is 0.
31028f39f02SMax ShvetsovCTX_INCLUDE_EL2_REGS		:= 0
3117ff088d1SManish V Badarkhe
3127ff088d1SManish V Badarkhe# Enable Memory tag extension which is supported for architecture greater
3137ff088d1SManish V Badarkhe# than Armv8.5-A
3147ff088d1SManish V Badarkhe# By default it is set to "no"
3157ff088d1SManish V BadarkheSUPPORT_STACK_MEMTAG		:= no
31645aecff0SManish V Badarkhe
31745aecff0SManish V Badarkhe# Select workaround for AT speculative behaviour.
31845aecff0SManish V BadarkheERRATA_SPECULATIVE_AT           := 0
319fbc44bd1SVarun Wadekar
320fbc44bd1SVarun Wadekar# Trap RAS error record access from lower EL
321fbc44bd1SVarun WadekarRAS_TRAP_LOWER_EL_ERR_ACCESS	:= 0
32284ef9cd8SManish V Badarkhe
32384ef9cd8SManish V Badarkhe# Build option to create cot descriptors using fconf
32484ef9cd8SManish V BadarkheCOT_DESC_IN_DTB			:= 0
325582e4e7bSManish V Badarkhe
326582e4e7bSManish V Badarkhe# Build option to provide openssl directory path
327582e4e7bSManish V BadarkheOPENSSL_DIR			:= /usr
328fddfb3baSMadhukar Pappireddy
329fddfb3baSMadhukar Pappireddy# Build option to use the SP804 timer instead of the generic one
330fddfb3baSMadhukar PappireddyUSE_SP804_TIMER			:= 0
331