1120c43adSJerome Forissier# Default configuration values for OP-TEE core (all platforms). 2120c43adSJerome Forissier# 3120c43adSJerome Forissier# Platform-specific overrides are in core/arch/arm32/plat-*/conf.mk. 4120c43adSJerome Forissier# Some subsystem-specific defaults are not here but rather in */sub.mk. 5120c43adSJerome Forissier# 6120c43adSJerome Forissier# Configuration values may be assigned from multiple sources. 7120c43adSJerome Forissier# From higher to lower priority: 8120c43adSJerome Forissier# 9120c43adSJerome Forissier# 1. Make arguments ('make CFG_FOO=bar...') 10120c43adSJerome Forissier# 2. The file specified by $(CFG_OPTEE_CONFIG) (if defined) 11120c43adSJerome Forissier# 3. The environment ('CFG_FOO=bar make...') 12120c43adSJerome Forissier# 4. The platform-specific configuration file: core/arch/arm32/plat-*/conf.mk 13120c43adSJerome Forissier# 5. This file 14120c43adSJerome Forissier# 6. Subsystem-specific makefiles (*/sub.mk) 15120c43adSJerome Forissier# 16b5569a68SPascal Brand# Actual values used during the build are output to $(out-dir)/conf.mk 17120c43adSJerome Forissier# (CFG_* variables only). 18120c43adSJerome Forissier 19a75f2e14SJerome Forissier# Cross-compiler prefix and suffix 20a75f2e14SJerome ForissierCROSS_COMPILE ?= arm-linux-gnueabihf- 21c042fbefSJerome ForissierCROSS_COMPILE32 ?= $(CROSS_COMPILE) 22c042fbefSJerome ForissierCROSS_COMPILE64 ?= aarch64-linux-gnu- 23a75f2e14SJerome ForissierCOMPILER ?= gcc 24a75f2e14SJerome Forissier 25b09cddcaSJerome Forissier# For convenience 26b09cddcaSJerome Forissierifdef CFLAGS 27b09cddcaSJerome ForissierCFLAGS32 ?= $(CFLAGS) 28b09cddcaSJerome ForissierCFLAGS64 ?= $(CFLAGS) 29b09cddcaSJerome Forissierendif 30b09cddcaSJerome Forissier 31120c43adSJerome Forissier# Compiler warning level. 32120c43adSJerome Forissier# Supported values: undefined, 1, 2 and 3. 3 gives more warnings. 33b0104773SPascal BrandWARNS ?= 3 34b0104773SPascal Brand 35b4faf480SDick Olsson# Path to the Python interpreter used by the build system. 36b4faf480SDick Olsson# This variable is set to the default python3 interpreter in the user's 37b4faf480SDick Olsson# path. But build environments that require more explicit control can 38b4faf480SDick Olsson# set the path to a specific interpreter through this variable. 39b4faf480SDick OlssonPYTHON3 ?= python3 40b4faf480SDick Olsson 413f17b838SEtienne Carriere# Define DEBUG=1 to compile without optimization (forces -O0) 42b0104773SPascal Brand# DEBUG=1 430e6830baSEtienne Carriereifeq ($(DEBUG),1) 440e6830baSEtienne Carriere# For backwards compatibility 450e6830baSEtienne Carriere$(call force,CFG_CC_OPT_LEVEL,0) 460e6830baSEtienne Carriere$(call force,CFG_DEBUG_INFO,y) 470e6830baSEtienne Carriereendif 480e6830baSEtienne Carriere 490e6830baSEtienne Carriere# CFG_CC_OPT_LEVEL sets compiler optimization level passed with -O directive. 500e6830baSEtienne Carriere# Optimize for size by default, usually gives good performance too. 510e6830baSEtienne CarriereCFG_CC_OPT_LEVEL ?= s 520e6830baSEtienne Carriere 530e6830baSEtienne Carriere# Enabling CFG_DEBUG_INFO makes debug information embedded in core. 540e6830baSEtienne CarriereCFG_DEBUG_INFO ?= y 55b0104773SPascal Brand 564ec2358eSJerome Forissier# If y, enable debug features of the TEE core (assertions and lock checks 574ec2358eSJerome Forissier# are enabled, panic and assert messages are more verbose, data and prefetch 584ec2358eSJerome Forissier# aborts show a stack dump). When disabled, the NDEBUG directive is defined 594ec2358eSJerome Forissier# so assertions are disabled. 604ec2358eSJerome ForissierCFG_TEE_CORE_DEBUG ?= y 61b0104773SPascal Brand 623f58e4ecSOvidiu Mihalachi# Log levels for the TEE core. Defines which core messages are displayed 633f58e4ecSOvidiu Mihalachi# on the secure console. Disabling core log (level set to 0) also disables 643f58e4ecSOvidiu Mihalachi# logs from the TAs. 6509ca9f8bSJerome Forissier# 0: none 6609ca9f8bSJerome Forissier# 1: error 6714c68b3cSJerome Forissier# 2: error + info 6814c68b3cSJerome Forissier# 3: error + info + debug 6914c68b3cSJerome Forissier# 4: error + info + debug + flow 7014c68b3cSJerome ForissierCFG_TEE_CORE_LOG_LEVEL ?= 2 713f58e4ecSOvidiu Mihalachi 723f58e4ecSOvidiu Mihalachi# TA log level 733f58e4ecSOvidiu Mihalachi# If user-mode library libutils.a is built with CFG_TEE_TA_LOG_LEVEL=0, 743f58e4ecSOvidiu Mihalachi# TA tracing is disabled regardless of the value of CFG_TEE_TA_LOG_LEVEL 753f58e4ecSOvidiu Mihalachi# when the TA is built. 76e0042c88SPascal BrandCFG_TEE_TA_LOG_LEVEL ?= 1 77b0104773SPascal Brand 787c876f12SPascal Brand# TA enablement 797c876f12SPascal Brand# When defined to "y", TA traces are output according to 807c876f12SPascal Brand# CFG_TEE_TA_LOG_LEVEL. Otherwise, they are not output at all 817c876f12SPascal BrandCFG_TEE_CORE_TA_TRACE ?= y 82b0104773SPascal Brand 838c8e1441SJerome Forissier# If y, enable the memory leak detection feature in the bget memory allocator. 848c8e1441SJerome Forissier# When this feature is enabled, calling mdbg_check(1) will print a list of all 858c8e1441SJerome Forissier# the currently allocated buffers and the location of the allocation (file and 868c8e1441SJerome Forissier# line number). 878c8e1441SJerome Forissier# Note: make sure the log level is high enough for the messages to show up on 888c8e1441SJerome Forissier# the secure console! For instance: 898c8e1441SJerome Forissier# - To debug user-mode (TA) allocations: build OP-TEE *and* the TA with: 908c8e1441SJerome Forissier# $ make CFG_TEE_TA_MALLOC_DEBUG=y CFG_TEE_TA_LOG_LEVEL=3 918c8e1441SJerome Forissier# - To debug TEE core allocations: build OP-TEE with: 928c8e1441SJerome Forissier# $ make CFG_TEE_CORE_MALLOC_DEBUG=y CFG_TEE_CORE_LOG_LEVEL=3 930fcbddd4SSY ChiuCFG_TEE_CORE_MALLOC_DEBUG ?= n 940fcbddd4SSY ChiuCFG_TEE_TA_MALLOC_DEBUG ?= n 95c2ce4186SJens Wiklander# Prints an error message and dumps the stack on failed memory allocations 96c2ce4186SJens Wiklander# using malloc() and friends. 97c2ce4186SJens WiklanderCFG_CORE_DUMP_OOM ?= $(CFG_TEE_CORE_MALLOC_DEBUG) 980fcbddd4SSY Chiu 992bfab756SJerome Forissier# Mask to select which messages are prefixed with long debugging information 10064fad262SVolodymyr Babchuk# (severity, core ID, thread ID, component name, function name, line number) 10164fad262SVolodymyr Babchuk# based on the message level. If BIT(level) is set, the long prefix is shown. 1022bfab756SJerome Forissier# Otherwise a short prefix is used (severity and component name only). 103f4aa5b11SJerome Forissier# Levels: 0=none 1=error 2=info 3=debug 4=flow 1042bfab756SJerome ForissierCFG_MSG_LONG_PREFIX_MASK ?= 0x1a 105f4aa5b11SJerome Forissier 106120c43adSJerome Forissier# Number of threads 107120c43adSJerome ForissierCFG_NUM_THREADS ?= 2 108ab35d7adSCedric Chaumont 109ab35d7adSCedric Chaumont# API implementation version 110ab35d7adSCedric ChaumontCFG_TEE_API_VERSION ?= GPD-1.1-dev 111ab35d7adSCedric Chaumont 112ab35d7adSCedric Chaumont# Implementation description (implementation-dependent) 113ab35d7adSCedric ChaumontCFG_TEE_IMPL_DESCR ?= OPTEE 114ab35d7adSCedric Chaumont 11529cff5cfSJerome Forissier# Should OPTEE_SMC_CALL_GET_OS_REVISION return a build identifier to Normal 11629cff5cfSJerome Forissier# World? 11729cff5cfSJerome ForissierCFG_OS_REV_REPORTS_GIT_SHA1 ?= y 11829cff5cfSJerome Forissier 11935c507f2SJerome Forissier# The following values are not extracted from the "git describe" output because 12035c507f2SJerome Forissier# we might be outside of a Git environment, or the tree may have been cloned 12135c507f2SJerome Forissier# with limited depth not including any tag, so there is really no guarantee 12235c507f2SJerome Forissier# that TEE_IMPL_VERSION contains the major and minor revision numbers. 1232a5b1d12SJerome ForissierCFG_OPTEE_REVISION_MAJOR ?= 4 1242a5b1d12SJerome ForissierCFG_OPTEE_REVISION_MINOR ?= 0 1253bfa418bSJerome ForissierCFG_OPTEE_REVISION_EXTRA ?= 126ab35d7adSCedric Chaumont 12748ca43e8SJerome Forissier# Trusted OS implementation version 12848ca43e8SJerome ForissierTEE_IMPL_VERSION ?= $(shell git describe --always --dirty=-dev 2>/dev/null || \ 1293bfa418bSJerome Forissier echo Unknown_$(CFG_OPTEE_REVISION_MAJOR).$(CFG_OPTEE_REVISION_MINOR))$(CFG_OPTEE_REVISION_EXTRA) 13048ca43e8SJerome Forissierifeq ($(CFG_OS_REV_REPORTS_GIT_SHA1),y) 13148ca43e8SJerome ForissierTEE_IMPL_GIT_SHA1 := 0x$(shell git rev-parse --short=8 HEAD 2>/dev/null || echo 0) 13248ca43e8SJerome Forissierelse 13348ca43e8SJerome ForissierTEE_IMPL_GIT_SHA1 := 0x0 13448ca43e8SJerome Forissierendif 13548ca43e8SJerome Forissier 136ab35d7adSCedric Chaumont# Trusted OS implementation manufacturer name 137ab35d7adSCedric ChaumontCFG_TEE_MANUFACTURER ?= LINARO 138ab35d7adSCedric Chaumont 139ab35d7adSCedric Chaumont# Trusted firmware version 140ab35d7adSCedric ChaumontCFG_TEE_FW_IMPL_VERSION ?= FW_IMPL_UNDEF 141ab35d7adSCedric Chaumont 142ab35d7adSCedric Chaumont# Trusted OS implementation manufacturer name 143ab35d7adSCedric ChaumontCFG_TEE_FW_MANUFACTURER ?= FW_MAN_UNDEF 144ab35d7adSCedric Chaumont 145b44708c1SJerome Forissier# Rich Execution Environment (REE) file system support: normal world OS 146b44708c1SJerome Forissier# provides the actual storage. 147b44708c1SJerome Forissier# This is the default FS when enabled (i.e., the one used when 148b44708c1SJerome Forissier# TEE_STORAGE_PRIVATE is passed to the trusted storage API) 149b44708c1SJerome ForissierCFG_REE_FS ?= y 150bc420748SJens Wiklander 15188e6e089SJerome Forissier# RPMB file system support 15288e6e089SJerome ForissierCFG_RPMB_FS ?= n 15388e6e089SJerome Forissier 154f5411aafSJudy Wang# Enable roll-back protection of REE file system using RPMB. 155f5411aafSJudy Wang# Roll-back protection only works if CFG_RPMB_FS = y. 156f5411aafSJudy WangCFG_REE_FS_INTEGRITY_RPMB ?= $(CFG_RPMB_FS) 157f5411aafSJudy Wang$(eval $(call cfg-depends-all,CFG_REE_FS_INTEGRITY_RPMB,CFG_RPMB_FS)) 158f5411aafSJudy Wang 15988e6e089SJerome Forissier# Device identifier used when CFG_RPMB_FS = y. 16088e6e089SJerome Forissier# The exact meaning of this value is platform-dependent. On Linux, the 16188e6e089SJerome Forissier# tee-supplicant process will open /dev/mmcblk<id>rpmb 16288e6e089SJerome ForissierCFG_RPMB_FS_DEV_ID ?= 0 16388e6e089SJerome Forissier 1647d97159bSManuel Huber# This config variable determines the number of entries read in from RPMB at 1657d97159bSManuel Huber# once whenever a function traverses the RPMB FS. Increasing the default value 1667d97159bSManuel Huber# has the following consequences: 1677d97159bSManuel Huber# - More memory required on heap. A single FAT entry currently has a size of 1687d97159bSManuel Huber# 256 bytes. 1697d97159bSManuel Huber# - Potentially significant speed-ups for RPMB I/O. Depending on how many 1707d97159bSManuel Huber# entries a function needs to traverse, the number of time-consuming RPMB 1717d97159bSManuel Huber# read-in operations can be reduced. 1727d97159bSManuel Huber# Chosing a proper value is both platform- (available memory) and use-case- 1737d97159bSManuel Huber# dependent (potential number of FAT fs entries), so overwrite in platform 1747d97159bSManuel Huber# config files 1757d97159bSManuel HuberCFG_RPMB_FS_RD_ENTRIES ?= 8 1767d97159bSManuel Huber 1775f68d784SManuel Huber# Enables caching of FAT FS entries when set to a value greater than zero. 1785f68d784SManuel Huber# When enabled, the cache stores the first 'CFG_RPMB_FS_CACHE_ENTRIES' FAT FS 1795f68d784SManuel Huber# entries. The cache is populated when FAT FS entries are initially read in. 1805f68d784SManuel Huber# When traversing the FAT FS entries, we read from the cache instead of reading 1815f68d784SManuel Huber# in the entries from RPMB storage. Consequently, when a FAT FS entry is 1825f68d784SManuel Huber# written, the cache is updated. In scenarios where an estimate of the number 1835f68d784SManuel Huber# of FAT FS entries can be made, the cache may be specifically tailored to 1845f68d784SManuel Huber# store all entries. The caching can improve RPMB I/O at the cost 1855f68d784SManuel Huber# of additional memory. 1865f68d784SManuel Huber# Without caching, we temporarily require 1875f68d784SManuel Huber# CFG_RPMB_FS_RD_ENTRIES*sizeof(struct rpmb_fat_entry) bytes of heap memory 1885f68d784SManuel Huber# while traversing the FAT FS (e.g. in read_fat). 1895f68d784SManuel Huber# For example 8*256 bytes = 2kB while in read_fat. 1905f68d784SManuel Huber# With caching, we constantly require up to 1915f68d784SManuel Huber# CFG_RPMB_FS_CACHE_ENTRIES*sizeof(struct rpmb_fat_entry) bytes of heap memory 1925f68d784SManuel Huber# depending on how many elements are in the cache, and additional temporary 1935f68d784SManuel Huber# CFG_RPMB_FS_RD_ENTRIES*sizeof(struct rpmb_fat_entry) bytes of heap memory 1945f68d784SManuel Huber# in case the cache is too small to hold all elements when traversing. 1955f68d784SManuel HuberCFG_RPMB_FS_CACHE_ENTRIES ?= 0 1965f68d784SManuel Huber 1978443e88eSEtienne Carriere# Print RPMB data frames sent to and received from the RPMB device 1988443e88eSEtienne CarriereCFG_RPMB_FS_DEBUG_DATA ?= n 1998443e88eSEtienne Carriere 2008443e88eSEtienne Carriere# Clear RPMB content at cold boot 2018443e88eSEtienne CarriereCFG_RPMB_RESET_FAT ?= n 2028443e88eSEtienne Carriere 2038443e88eSEtienne Carriere# Use a hard coded RPMB key instead of deriving it from the platform HUK 2048443e88eSEtienne CarriereCFG_RPMB_TESTKEY ?= n 2058443e88eSEtienne Carriere 206ed1993b7SJerome Forissier# Enables RPMB key programming by the TEE, in case the RPMB partition has not 207ed1993b7SJerome Forissier# been configured yet. 208ed1993b7SJerome Forissier# !!! Security warning !!! 209ed1993b7SJerome Forissier# Do *NOT* enable this in product builds, as doing so would allow the TEE to 210ed1993b7SJerome Forissier# leak the RPMB key. 211ed1993b7SJerome Forissier# This option is useful in the following situations: 212ed1993b7SJerome Forissier# - Testing 213ed1993b7SJerome Forissier# - RPMB key provisioning in a controlled environment (factory setup) 214ed1993b7SJerome ForissierCFG_RPMB_WRITE_KEY ?= n 215ed1993b7SJerome Forissier 21607fda6c7SJerome Forissier_CFG_WITH_SECURE_STORAGE := $(call cfg-one-enabled,CFG_REE_FS CFG_RPMB_FS) 21707fda6c7SJerome Forissier 2183ecd96bbSVesa Jääskeläinen# Signing key for OP-TEE TA's 2193ecd96bbSVesa Jääskeläinen# When performing external HSM signing for TA's TA_SIGN_KEY can be set to dummy 2203ecd96bbSVesa Jääskeläinen# key and then set TA_PUBLIC_KEY to match public key from the HSM. 2213ecd96bbSVesa Jääskeläinen# TA_PUBLIC_KEY's public key will be embedded into OP-TEE OS. 222bc420748SJens WiklanderTA_SIGN_KEY ?= keys/default_ta.pem 2233ecd96bbSVesa JääskeläinenTA_PUBLIC_KEY ?= $(TA_SIGN_KEY) 224c4553de7SJerome Forissier 225c34d0d91SJens Wiklander# Subkeys is a complement to the normal TA_SIGN_KEY where a subkey is used 226c34d0d91SJens Wiklander# to verify a TA instead. To sign a TA using a previously prepared subkey 227c34d0d91SJens Wiklander# two new options are added, TA_SUBKEY_ARGS and TA_SUBKEY_DEPS. It is 228c34d0d91SJens Wiklander# typically used by assigning the following in the TA Makefile: 229c34d0d91SJens Wiklander# BINARY = <TA-uuid-string> 230c34d0d91SJens Wiklander# TA_SIGN_KEY = subkey.pem 231c34d0d91SJens Wiklander# TA_SUBKEY_ARGS = --subkey subkey.bin --name subkey_ta 232c34d0d91SJens Wiklander# TA_SUBKEY_DEPS = subkey.bin 233c34d0d91SJens Wiklander# See the documentation for more details on subkeys. 234c34d0d91SJens Wiklander 235c4553de7SJerome Forissier# Include lib/libutils/isoc in the build? Most platforms need this, but some 236c4553de7SJerome Forissier# may not because they obtain the isoc functions from elsewhere 237c4553de7SJerome ForissierCFG_LIBUTILS_WITH_ISOC ?= y 238fce4cfa1SJens Wiklander 2390de9a5fbSJens Wiklander# Enables floating point support for user TAs 2400de9a5fbSJens Wiklander# ARM32: EABI defines both a soft-float ABI and a hard-float ABI, 2410de9a5fbSJens Wiklander# hard-float is basically a super set of soft-float. Hard-float 2420de9a5fbSJens Wiklander# requires all the support routines provided for soft-float, but the 2430de9a5fbSJens Wiklander# compiler may choose to optimize to not use some of them and use 2440de9a5fbSJens Wiklander# the floating-point registers instead. 2450de9a5fbSJens Wiklander# ARM64: EABI doesn't define a soft-float ABI, everything is hard-float (or 2460de9a5fbSJens Wiklander# nothing with ` -mgeneral-regs-only`) 2470de9a5fbSJens Wiklander# With CFG_TA_FLOAT_SUPPORT enabled TA code is free use floating point types 2480de9a5fbSJens WiklanderCFG_TA_FLOAT_SUPPORT ?= y 249923c1f34SJens Wiklander 2507411e0e1SJerome Forissier# Stack unwinding: print a stack dump to the console on core or TA abort, or 2517411e0e1SJerome Forissier# when a TA panics. 25231a29642SJerome Forissier# If CFG_UNWIND is enabled, both the kernel and user mode call stacks can be 25331a29642SJerome Forissier# unwound (not paged TAs, however). 25431a29642SJerome Forissier# Note that 32-bit ARM code needs unwind tables for this to work, so enabling 25531a29642SJerome Forissier# this option will increase the size of the 32-bit TEE binary by a few KB. 25631a29642SJerome Forissier# Similarly, TAs have to be compiled with -funwind-tables (default when the 25731a29642SJerome Forissier# option is set) otherwise they can't be unwound. 2587411e0e1SJerome Forissier# Warning: since the unwind sequence for user-mode (TA) code is implemented in 2597411e0e1SJerome Forissier# the privileged layer of OP-TEE, enabling this feature will weaken the 2607411e0e1SJerome Forissier# user/kernel isolation. Therefore it should be disabled in release builds. 2613f17b838SEtienne Carriereifeq ($(CFG_TEE_CORE_DEBUG),y) 26231a29642SJerome ForissierCFG_UNWIND ?= y 263923c1f34SJens Wiklanderendif 2646fbac37eSJens Wiklander 2656fbac37eSJens Wiklander# Enable support for dynamically loaded user TAs 2666fbac37eSJens WiklanderCFG_WITH_USER_TA ?= y 2672a142248SJens Wiklander 2682c20168bSBalsam CHIHI# Build user TAs included in this source tree 2692c20168bSBalsam CHIHICFG_BUILD_IN_TREE_TA ?= y 2702c20168bSBalsam CHIHI 27124d49094SJerome Forissier# Choosing the architecture(s) of user-mode libraries (used by TAs) 27224d49094SJerome Forissier# 27324d49094SJerome Forissier# Platforms may define a list of supported architectures for user-mode code 27424d49094SJerome Forissier# by setting $(supported-ta-targets). Valid values are "ta_arm32", "ta_arm64", 27524d49094SJerome Forissier# "ta_arm32 ta_arm64" and "ta_arm64 ta_arm32". 27624d49094SJerome Forissier# $(supported-ta-targets) defaults to "ta_arm32" when the TEE core is 32-bits, 27724d49094SJerome Forissier# and "ta_arm32 ta_arm64" when it is 64-bits (that is, when CFG_ARM64_core=y). 27824d49094SJerome Forissier# The first entry in $(supported-ta-targets) has a special role, see 27924d49094SJerome Forissier# CFG_USER_TA_TARGET_<ta-name> below. 28024d49094SJerome Forissier# 28124d49094SJerome Forissier# CFG_USER_TA_TARGETS may be defined to restrict $(supported-ta-targets) or 28224d49094SJerome Forissier# change the order of the values. 28324d49094SJerome Forissier# 28424d49094SJerome Forissier# The list of TA architectures is ultimately stored in $(ta-targets). 28524d49094SJerome Forissier 28624d49094SJerome Forissier# CFG_USER_TA_TARGET_<ta-name> (for example, CFG_USER_TA_TARGET_avb), if 28724d49094SJerome Forissier# defined, selects the unique TA architecture mode for building the in-tree TA 28824d49094SJerome Forissier# <ta-name>. Can be either ta_arm32 or ta_arm64. 28924d49094SJerome Forissier# By default, in-tree TAs are built using the first architecture specified in 29024d49094SJerome Forissier# $(ta-targets). 29124d49094SJerome Forissier 2927dfff131SJerome Forissier# Address Space Layout Randomization for user-mode Trusted Applications 2937dfff131SJerome Forissier# 2947dfff131SJerome Forissier# When this flag is enabled, the ELF loader will introduce a random offset 2957dfff131SJerome Forissier# when mapping the application in user space. ASLR makes the exploitation of 2967dfff131SJerome Forissier# memory corruption vulnerabilities more difficult. 29787372da4SJens WiklanderCFG_TA_ASLR ?= y 2987dfff131SJerome Forissier 2997dfff131SJerome Forissier# How much ASLR may shift the base address (in pages). The base address is 3007dfff131SJerome Forissier# randomly shifted by an integer number of pages comprised between these two 3017dfff131SJerome Forissier# values. Bigger ranges are more secure because they make the addresses harder 3027dfff131SJerome Forissier# to guess at the expense of using more memory for the page tables. 3037dfff131SJerome ForissierCFG_TA_ASLR_MIN_OFFSET_PAGES ?= 0 3047dfff131SJerome ForissierCFG_TA_ASLR_MAX_OFFSET_PAGES ?= 128 3057dfff131SJerome Forissier 306170e9084SJens Wiklander# Address Space Layout Randomization for TEE Core 307170e9084SJens Wiklander# 308170e9084SJens Wiklander# When this flag is enabled, the early init code will introduce a random 309170e9084SJens Wiklander# offset when mapping TEE Core. ASLR makes the exploitation of memory 310170e9084SJens Wiklander# corruption vulnerabilities more difficult. 31187372da4SJens WiklanderCFG_CORE_ASLR ?= y 312170e9084SJens Wiklander 31345507d10SKhoa Hoang# Stack Protection for TEE Core 31445507d10SKhoa Hoang# This flag enables the compiler stack protection mechanisms -fstack-protector. 31545507d10SKhoa Hoang# It will check the stack canary value before returning from a function to 31645507d10SKhoa Hoang# prevent buffer overflow attacks. Stack protector canary logic will be added 31745507d10SKhoa Hoang# for vulnerable functions that contain: 31845507d10SKhoa Hoang# - A character array larger than 8 bytes. 31945507d10SKhoa Hoang# - An 8-bit integer array larger than 8 bytes. 32045507d10SKhoa Hoang# - A call to alloca() with either a variable size or a constant size bigger 32145507d10SKhoa Hoang# than 8 bytes. 32245507d10SKhoa HoangCFG_CORE_STACK_PROTECTOR ?= n 32345507d10SKhoa Hoang# This enable stack protector flag -fstack-protector-strong. Stack protector 32445507d10SKhoa Hoang# canary logic will be added for vulnerable functions that contain: 32545507d10SKhoa Hoang# - An array of any size and type. 32645507d10SKhoa Hoang# - A call to alloca(). 32745507d10SKhoa Hoang# - A local variable that has its address taken. 32845507d10SKhoa HoangCFG_CORE_STACK_PROTECTOR_STRONG ?= y 32945507d10SKhoa Hoang# This enable stack protector flag -fstack-protector-all. Stack protector canary 33045507d10SKhoa Hoang# logic will be added to all functions regardless of their vulnerability. 33145507d10SKhoa HoangCFG_CORE_STACK_PROTECTOR_ALL ?= n 33245507d10SKhoa Hoang# Stack Protection for TA 33345507d10SKhoa HoangCFG_TA_STACK_PROTECTOR ?= n 33445507d10SKhoa HoangCFG_TA_STACK_PROTECTOR_STRONG ?= y 33545507d10SKhoa HoangCFG_TA_STACK_PROTECTOR_ALL ?= n 33645507d10SKhoa Hoang 33745507d10SKhoa Hoang_CFG_CORE_STACK_PROTECTOR := $(call cfg-one-enabled, CFG_CORE_STACK_PROTECTOR \ 33845507d10SKhoa Hoang CFG_CORE_STACK_PROTECTOR_STRONG \ 33945507d10SKhoa Hoang CFG_CORE_STACK_PROTECTOR_ALL) 34045507d10SKhoa Hoang_CFG_TA_STACK_PROTECTOR := $(call cfg-one-enabled, CFG_TA_STACK_PROTECTOR \ 34145507d10SKhoa Hoang CFG_TA_STACK_PROTECTOR_STRONG \ 34245507d10SKhoa Hoang CFG_TA_STACK_PROTECTOR_ALL) 34345507d10SKhoa Hoang 344ee664c19SJerome Forissier# Load user TAs from the REE filesystem via tee-supplicant 345ee664c19SJerome ForissierCFG_REE_FS_TA ?= y 346ee664c19SJerome Forissier 3477db24ad6SJerome Forissier# Pre-authentication of TA binaries loaded from the REE filesystem 3487db24ad6SJerome Forissier# 3497db24ad6SJerome Forissier# - If CFG_REE_FS_TA_BUFFERED=y: load TA binary into a temporary buffer in the 3507db24ad6SJerome Forissier# "Secure DDR" pool, check the signature, then process the file only if it is 3517db24ad6SJerome Forissier# valid. 3527db24ad6SJerome Forissier# - If disabled: hash the binaries as they are being processed and verify the 3537db24ad6SJerome Forissier# signature as a last step. 354e6e68745SJerome ForissierCFG_REE_FS_TA_BUFFERED ?= n 3557db24ad6SJerome Forissier$(eval $(call cfg-depends-all,CFG_REE_FS_TA_BUFFERED,CFG_REE_FS_TA)) 3567db24ad6SJerome Forissier 357623b9bd4SJens Wiklander# When CFG_REE_FS=y: 358300faa62SEtienne Carriere# Allow secure storage in the REE FS to be entirely deleted without causing 359300faa62SEtienne Carriere# anti-rollback errors. That is, rm /data/tee/dirf.db or rm -rf /data/tee (or 360300faa62SEtienne Carriere# whatever path is configured in tee-supplicant as CFG_TEE_FS_PARENT_PATH) 361300faa62SEtienne Carriere# can be used to reset the secure storage to a clean, empty state. 362300faa62SEtienne Carriere# Typically used for testing only since it weakens storage security. 363300faa62SEtienne CarriereCFG_REE_FS_ALLOW_RESET ?= n 364300faa62SEtienne Carriere 365d0c63614SJerome Forissier# Support for loading user TAs from a special section in the TEE binary. 366d0c63614SJerome Forissier# Such TAs are available even before tee-supplicant is available (hence their 367d0c63614SJerome Forissier# name), but note that many services exported to TAs may need tee-supplicant, 368d0c63614SJerome Forissier# so early use is limited to a subset of the TEE Internal Core API (crypto...) 369d0c63614SJerome Forissier# To use this feature, set EARLY_TA_PATHS to the paths to one or more TA ELF 370d0c63614SJerome Forissier# file(s). For example: 371d0c63614SJerome Forissier# $ make ... \ 372d0c63614SJerome Forissier# EARLY_TA_PATHS="path/to/8aaaf200-2450-11e4-abe2-0002a5d5c51b.stripped.elf \ 373d0c63614SJerome Forissier# path/to/cb3e5ba0-adf1-11e0-998b-0002a5d5c51b.stripped.elf" 374d0c63614SJerome Forissier# Typical build steps: 375d0c63614SJerome Forissier# $ make ta_dev_kit CFG_EARLY_TA=y # Create the dev kit (user mode libraries, 376d0c63614SJerome Forissier# # headers, makefiles), ready to build TAs. 377d0c63614SJerome Forissier# # CFG_EARLY_TA=y is optional, it prevents 378d0c63614SJerome Forissier# # later library recompilations. 379d0c63614SJerome Forissier# <build some TAs> 380d0c63614SJerome Forissier# $ make EARLY_TA_PATHS=<paths> # Build OP-TEE and embbed the TA(s) 3813638ea32SJens Wiklander# 3823638ea32SJens Wiklander# Another option is CFG_IN_TREE_EARLY_TAS which is used to point at 3833638ea32SJens Wiklander# in-tree TAs. CFG_IN_TREE_EARLY_TAS is formatted as: 3843638ea32SJens Wiklander# <name-of-ta>/<uuid> 3853638ea32SJens Wiklander# for instance avb/023f8f1a-292a-432b-8fc4-de8471358067 3863638ea32SJens Wiklanderifneq ($(EARLY_TA_PATHS)$(CFG_IN_TREE_EARLY_TAS),) 387d0c63614SJerome Forissier$(call force,CFG_EARLY_TA,y) 388d0c63614SJerome Forissierelse 389d0c63614SJerome ForissierCFG_EARLY_TA ?= n 390d0c63614SJerome Forissierendif 391dea46be3SJelle Sels 39205ee04a8SJelle Selsifeq ($(CFG_EARLY_TA),y) 39305ee04a8SJelle Sels$(call force,CFG_EMBEDDED_TS,y) 39405ee04a8SJelle Selsendif 39505ee04a8SJelle Sels 396dea46be3SJelle Selsifneq ($(SP_PATHS),) 397dea46be3SJelle Sels$(call force,CFG_EMBEDDED_TS,y) 398dea46be3SJelle Selselse 399dea46be3SJelle SelsCFG_SECURE_PARTITION ?= n 400dea46be3SJelle Selsendif 401dea46be3SJelle Sels 40205ee04a8SJelle Selsifeq ($(CFG_SECURE_PARTITION),y) 40305ee04a8SJelle Sels$(call force,CFG_EMBEDDED_TS,y) 40405ee04a8SJelle Selsendif 40505ee04a8SJelle Sels 406dea46be3SJelle Selsifeq ($(CFG_EMBEDDED_TS),y) 407509a9802SJerome Forissier$(call force,CFG_ZLIB,y) 408509a9802SJerome Forissierendif 409d0c63614SJerome Forissier 410c082c54dSEtienne Carriere# By default the early TAs are compressed in the TEE binary, it is possible to 411c082c54dSEtienne Carriere# not compress them with CFG_EARLY_TA_COMPRESS=n 412c082c54dSEtienne CarriereCFG_EARLY_TA_COMPRESS ?= y 413c082c54dSEtienne Carriere 414a884c935SJens Wiklander# Enable paging, requires SRAM, can't be enabled by default 415a884c935SJens WiklanderCFG_WITH_PAGER ?= n 416a884c935SJens Wiklander 417b757e307SJens Wiklander# Use the pager for user TAs 418b757e307SJens WiklanderCFG_PAGED_USER_TA ?= $(CFG_WITH_PAGER) 419b757e307SJens Wiklander 420b757e307SJens Wiklander# If paging of user TAs, that is, R/W paging default to enable paging of 421b757e307SJens Wiklander# TAG and IV in order to reduce heap usage. 422b757e307SJens WiklanderCFG_CORE_PAGE_TAG_AND_IV ?= $(CFG_PAGED_USER_TA) 423b757e307SJens Wiklander 424ab0df69eSJerome Forissier# Runtime lock dependency checker: ensures that a proper locking hierarchy is 425ab0df69eSJerome Forissier# used in the TEE core when acquiring and releasing mutexes. Any violation will 426ab0df69eSJerome Forissier# cause a panic as soon as the invalid locking condition is detected. If 4272288b071SJerome Forissier# CFG_UNWIND and CFG_LOCKDEP_RECORD_STACK are both enabled, the algorithm 4282288b071SJerome Forissier# records the call stacks when locks are taken, and prints them when a 4292288b071SJerome Forissier# potential deadlock is found. 430ab0df69eSJerome Forissier# Expect a significant performance impact when enabling this. 431ab0df69eSJerome ForissierCFG_LOCKDEP ?= n 4322288b071SJerome ForissierCFG_LOCKDEP_RECORD_STACK ?= y 433ab0df69eSJerome Forissier 434bde8a250SJoakim Bech# BestFit algorithm in bget reduces the fragmentation of the heap when running 435ab0df69eSJerome Forissier# with the pager enabled or lockdep 436ab0df69eSJerome ForissierCFG_CORE_BGET_BESTFIT ?= $(call cfg-one-enabled, CFG_WITH_PAGER CFG_LOCKDEP) 437bde8a250SJoakim Bech 438be715239SJens Wiklander# Enable support for detected undefined behavior in C 4391d171f95SJens Wiklander# Uses a lot of memory, can't be enabled by default 440be715239SJens WiklanderCFG_CORE_SANITIZE_UNDEFINED ?= n 441b908c675SJens Wiklander 4421d171f95SJens Wiklander# Enable Kernel Address sanitizer, has a huge performance impact, uses a 4431d171f95SJens Wiklander# lot of memory and need platform specific adaptations, can't be enabled by 4441d171f95SJens Wiklander# default 4451d171f95SJens WiklanderCFG_CORE_SANITIZE_KADDRESS ?= n 4461d171f95SJens Wiklander 44783d0edeeSJerome Forissierifeq (y-y,$(CFG_CORE_SANITIZE_KADDRESS)-$(CFG_CORE_ASLR)) 44883d0edeeSJerome Forissier$(error CFG_CORE_SANITIZE_KADDRESS and CFG_CORE_ASLR are not compatible) 44983d0edeeSJerome Forissierendif 45083d0edeeSJerome Forissier 45135e770dfSJerome Forissier# Add stack guards before/after stacks and periodically check them 45235e770dfSJerome ForissierCFG_WITH_STACK_CANARIES ?= y 45335e770dfSJerome Forissier 454e2f03e07SJerome Forissier# Use compiler instrumentation to troubleshoot stack overflows. 455e2f03e07SJerome Forissier# When enabled, most C functions check the stack pointer against the current 456e2f03e07SJerome Forissier# stack limits on entry and panic immediately if it is out of range. 457e2f03e07SJerome ForissierCFG_CORE_DEBUG_CHECK_STACKS ?= n 458e2f03e07SJerome Forissier 459cca7b5ebSJorge Ramirez-Ortiz# Use when the default stack allocations are not sufficient. 460cca7b5ebSJorge Ramirez-OrtizCFG_STACK_THREAD_EXTRA ?= 0 461cca7b5ebSJorge Ramirez-OrtizCFG_STACK_TMP_EXTRA ?= 0 462cca7b5ebSJorge Ramirez-Ortiz 463b908c675SJens Wiklander# Device Tree support 464c95b9511SEtienne Carriere# 465c95b9511SEtienne Carriere# When CFG_DT is enabled core embeds the FDT library (libfdt) allowing 466c95b9511SEtienne Carriere# device tree blob (DTB) parsing from the core. 467c95b9511SEtienne Carriere# 468c95b9511SEtienne Carriere# When CFG_DT is enabled, the TEE _start function expects to find 469c95b9511SEtienne Carriere# the address of a DTB in register X2/R2 provided by the early boot stage 470c95b9511SEtienne Carriere# or value 0 if boot stage provides no DTB. 471c95b9511SEtienne Carriere# 4727c2317a7SGatien Chevallier# When CFG_EXTERNAL_DT is enabled, the external device tree ABI is implemented 4737c2317a7SGatien Chevallier# and the external device tree is expected to be used/modified. Its value 4747c2317a7SGatien Chevallier# defaults to CFG_DT. 4757c2317a7SGatien Chevallier# 476bf31bf10SImre Kis# When CFG_MAP_EXT_DT_SECURE is enabled the external device tree is expected to 477bf31bf10SImre Kis# be in the secure memory. 478bf31bf10SImre Kis# 479c95b9511SEtienne Carriere# When CFG_EMBED_DTB is enabled, CFG_EMBED_DTB_SOURCE_FILE shall define the 480c95b9511SEtienne Carriere# relative path of a DTS file located in core/arch/$(ARCH)/dts. 481c95b9511SEtienne Carriere# The DTS file is compiled into a DTB file which content is embedded in a 482c95b9511SEtienne Carriere# read-only section of the core. 483c95b9511SEtienne Carriereifneq ($(strip $(CFG_EMBED_DTB_SOURCE_FILE)),) 484c95b9511SEtienne CarriereCFG_EMBED_DTB ?= y 485c95b9511SEtienne Carriereendif 4863050ae8aSJens Wiklanderifeq ($(filter y,$(CFG_EMBED_DTB) $(CFG_CORE_SEL1_SPMC) $(CFG_CORE_SEL2_SPMC) \ 4873050ae8aSJens Wiklander $(CFG_CORE_EL3_SPMC)),y) 488c95b9511SEtienne Carriere$(call force,CFG_DT,y) 489c95b9511SEtienne Carriereendif 490c95b9511SEtienne CarriereCFG_EMBED_DTB ?= n 491b908c675SJens WiklanderCFG_DT ?= n 4927c2317a7SGatien ChevallierCFG_EXTERNAL_DT ?= $(CFG_DT) 493bf31bf10SImre KisCFG_MAP_EXT_DT_SECURE ?= n 494bf31bf10SImre Kisifeq ($(CFG_MAP_EXT_DT_SECURE),y) 495bf31bf10SImre Kis$(call force,CFG_DT,y) 496bf31bf10SImre Kisendif 49776358becSJens Wiklander 498a1222502SRaymond Mao# This option enables OP-TEE to support boot arguments handover via Transfer 499a1222502SRaymond Mao# List defined in Firmware Handoff specification. 500a1222502SRaymond Mao# This feature requires the support of Device Tree. 501a1222502SRaymond MaoCFG_TRANSFER_LIST ?= n 502a1222502SRaymond Maoifeq ($(CFG_TRANSFER_LIST),y) 503a1222502SRaymond Mao$(call force,CFG_DT,y) 504a1222502SRaymond Mao$(call force,CFG_EXTERNAL_DT,y) 505a1222502SRaymond Mao$(call force,CFG_MAP_EXT_DT_SECURE,y) 506a1222502SRaymond Maoendif 507a1222502SRaymond Mao 50876358becSJens Wiklander# Maximum size of the Device Tree Blob, has to be large enough to allow 50976358becSJens Wiklander# editing of the supplied DTB. 51076358becSJens WiklanderCFG_DTB_MAX_SIZE ?= 0x10000 5114d62e91aSVictor Chong 512c36d2192SBalint Dobszay# Maximum size of the init info data passed to Secure Partitions. 513c36d2192SBalint DobszayCFG_SP_INIT_INFO_MAX_SIZE ?= 0x1000 514c36d2192SBalint Dobszay 5150a3ad9b6SBryan O'Donoghue# Device Tree Overlay support. 516c4544143SClément Léger# CFG_EXTERNAL_DTB_OVERLAY allows to append a DTB overlay into an existing 517c4544143SClément Léger# external DTB. The overlay is created when no valid DTB overlay is found. 518c4544143SClément Léger# CFG_GENERATE_DTB_OVERLAY allows to create a DTB overlay at external 519c4544143SClément Léger# DTB location. 520c4544143SClément Léger# External DTB location (physical address) is provided either by boot 521c4544143SClément Léger# argument arg2 or from CFG_DT_ADDR if defined. 522c4544143SClément Léger# A subsequent boot stage can then merge the generated overlay DTB into a main 5230a3ad9b6SBryan O'Donoghue# DTB using the standard fdt_overlay_apply() method. 5240a3ad9b6SBryan O'DonoghueCFG_EXTERNAL_DTB_OVERLAY ?= n 525c4544143SClément LégerCFG_GENERATE_DTB_OVERLAY ?= n 526c4544143SClément Léger 527c4544143SClément Légerifeq (y-y,$(CFG_EXTERNAL_DTB_OVERLAY)-$(CFG_GENERATE_DTB_OVERLAY)) 528c4544143SClément Léger$(error CFG_EXTERNAL_DTB_OVERLAY and CFG_GENERATE_DTB_OVERLAY are exclusive) 529c4544143SClément Légerendif 530c4544143SClément Léger_CFG_USE_DTB_OVERLAY := $(call cfg-one-enabled,CFG_EXTERNAL_DTB_OVERLAY \ 531c4544143SClément Léger CFG_GENERATE_DTB_OVERLAY) 5320a3ad9b6SBryan O'Donoghue 533313aa2a4SJens Wiklander# All embedded tests are supposed to be disabled by default, this flag 534313aa2a4SJens Wiklander# is used to control the default value of all other embedded tests 535313aa2a4SJens WiklanderCFG_ENABLE_EMBEDDED_TESTS ?= n 536313aa2a4SJens Wiklander 53735964dc9SEtienne Carriere# Enable core self tests and related pseudo TAs 538313aa2a4SJens WiklanderCFG_TEE_CORE_EMBED_INTERNAL_TESTS ?= $(CFG_ENABLE_EMBEDDED_TESTS) 5396d96f208Syanyan-wrs 54027e8d08dSJens Wiklander# Compiles bget_main_test() to be called from a test TA 54127e8d08dSJens WiklanderCFG_TA_BGET_TEST ?= $(CFG_ENABLE_EMBEDDED_TESTS) 54227e8d08dSJens Wiklander 5432c8bb257SThomas Perrot# CFG_DT_DRIVER_EMBEDDED_TEST when enabled embedded DT driver probing tests. 5442c8bb257SThomas Perrot# This also requires embedding a DTB with expected content. 5452c8bb257SThomas Perrot# Default disable CFG_DRIVERS_CLK_EARLY_PROBE to probe clocks as other drivers. 546d783b681SEtienne Carriere# A probe deferral test mandates CFG_DRIVERS_DT_RECURSIVE_PROBE=n. 547d783b681SEtienne CarriereCFG_DT_DRIVER_EMBEDDED_TEST ?= n 548d783b681SEtienne Carriereifeq ($(CFG_DT_DRIVER_EMBEDDED_TEST),y) 549d783b681SEtienne CarriereCFG_DRIVERS_CLK ?= y 5506e2fe64aSClément LégerCFG_DRIVERS_GPIO ?= y 551d783b681SEtienne CarriereCFG_DRIVERS_RSTCTRL ?= y 552d783b681SEtienne CarriereCFG_DRIVERS_CLK_EARLY_PROBE ?= n 553d783b681SEtienne Carriere$(call force,CFG_DRIVERS_DT_RECURSIVE_PROBE,n,Mandated by CFG_DT_DRIVER_EMBEDDED_TEST) 554d783b681SEtienne Carriereendif 555d783b681SEtienne Carriere 55649d026a9SEtienne Carriere# CFG_WITH_STATS when enabled embeds PTA statistics service to allow non-secure 55749d026a9SEtienne Carriere# clients to retrieve debug and statistics information on core and loaded TAs. 55849d026a9SEtienne CarriereCFG_WITH_STATS ?= n 55949d026a9SEtienne Carriere 5604101c34aSEtienne Carriere# CFG_DRIVERS_DT_RECURSIVE_PROBE when enabled forces a recursive subnode 5614101c34aSEtienne Carriere# parsing in the embedded DTB for driver probing. The alternative is 5624101c34aSEtienne Carriere# an exploration based on compatible drivers found. It is default disabled. 5634101c34aSEtienne CarriereCFG_DRIVERS_DT_RECURSIVE_PROBE ?= n 5644101c34aSEtienne Carriere 5656d96f208Syanyan-wrs# This option enables OP-TEE to respond to SMP boot request: the Rich OS 5666d96f208Syanyan-wrs# issues this to request OP-TEE to release secondaries cores out of reset, 5676d96f208Syanyan-wrs# with specific core number and non-secure entry address. 5686d96f208Syanyan-wrsCFG_BOOT_SECONDARY_REQUEST ?= n 5696d96f208Syanyan-wrs 570f5f914aaSJens Wiklander# Default heap size for Core, 64 kB 571f5f914aaSJens WiklanderCFG_CORE_HEAP_SIZE ?= 65536 572f3bb2312SJerome Forissier 573b76b2296SJerome Forissier# Default size of nexus heap. 16 kB. Used only if CFG_NS_VIRTUALIZATION 574386fc264SVolodymyr Babchuk# is enabled 575386fc264SVolodymyr BabchukCFG_CORE_NEX_HEAP_SIZE ?= 16384 576386fc264SVolodymyr Babchuk 577883c4be3SJerome Forissier# TA profiling. 578883c4be3SJerome Forissier# When this option is enabled, OP-TEE can execute Trusted Applications 579883c4be3SJerome Forissier# instrumented with GCC's -pg flag and will output profiling information 580883c4be3SJerome Forissier# in gmon.out format to /tmp/gmon-<ta_uuid>.out (path is defined in 581883c4be3SJerome Forissier# tee-supplicant) 5828800b01dSJerome Forissier# Note: this does not work well with shared libraries at the moment for a 5838800b01dSJerome Forissier# couple of reasons: 5848800b01dSJerome Forissier# 1. The profiling code assumes a unique executable section in the TA VA space. 5858800b01dSJerome Forissier# 2. The code used to detect at run time if the TA is intrumented assumes that 5868800b01dSJerome Forissier# the TA is linked statically. 587883c4be3SJerome ForissierCFG_TA_GPROF_SUPPORT ?= n 588f3bb2312SJerome Forissier 589b02ae382SSumit Garg# TA function tracing. 590b02ae382SSumit Garg# When this option is enabled, OP-TEE can execute Trusted Applications 591b02ae382SSumit Garg# instrumented with GCC's -pg flag and will output function tracing 5925c2c0fb3SJerome Forissier# information for all functions compiled with -pg to 5935c2c0fb3SJerome Forissier# /tmp/ftrace-<ta_uuid>.out (path is defined in tee-supplicant). 594099918f6SSumit GargCFG_FTRACE_SUPPORT ?= n 595b02ae382SSumit Garg 596099918f6SSumit Garg# Core syscall function tracing. 597099918f6SSumit Garg# When this option is enabled, OP-TEE core is instrumented with GCC's 598099918f6SSumit Garg# -pg flag and will output syscall function graph in user TA ftrace 599099918f6SSumit Garg# buffer 600099918f6SSumit GargCFG_SYSCALL_FTRACE ?= n 601099918f6SSumit Garg$(call cfg-depends-all,CFG_SYSCALL_FTRACE,CFG_FTRACE_SUPPORT) 602099918f6SSumit Garg 603883c4be3SJerome Forissier# Enable to compile user TA libraries with profiling (-pg). 604099918f6SSumit Garg# Depends on CFG_TA_GPROF_SUPPORT or CFG_FTRACE_SUPPORT. 605735565dbSSumit GargCFG_ULIBS_MCOUNT ?= n 6060f8adafeSJerome Forissier# Profiling/tracing of syscall wrapper (utee_*) 6070f8adafeSJerome ForissierCFG_SYSCALL_WRAPPERS_MCOUNT ?= $(CFG_ULIBS_MCOUNT) 608883c4be3SJerome Forissier 6090f8adafeSJerome Forissierifeq (y,$(filter y,$(CFG_ULIBS_MCOUNT) $(CFG_SYSCALL_WRAPPERS_MCOUNT))) 610099918f6SSumit Gargifeq (,$(filter y,$(CFG_TA_GPROF_SUPPORT) $(CFG_FTRACE_SUPPORT))) 611883c4be3SJerome Forissier$(error Cannot instrument user libraries if user mode profiling is disabled) 612f3bb2312SJerome Forissierendif 613f3bb2312SJerome Forissierendif 614cb0b5954SJens Wiklander 6157fb525f1SJerome Forissier# Build libutee, libutils, libmbedtls as shared libraries. 61664718c93SJerome Forissier# - Static libraries are still generated when this is enabled, but TAs will use 61764718c93SJerome Forissier# the shared libraries unless explicitly linked with the -static flag. 61864718c93SJerome Forissier# - Shared libraries are made of two files: for example, libutee is 61964718c93SJerome Forissier# libutee.so and 527f1a47-b92c-4a74-95bd-72f19f4a6f74.ta. The '.so' file 62064718c93SJerome Forissier# is a totally standard shared object, and should be used to link against. 62164718c93SJerome Forissier# The '.ta' file is a signed version of the '.so' and should be installed 62264718c93SJerome Forissier# in the same way as TAs so that they can be found at runtime. 62364718c93SJerome ForissierCFG_ULIBS_SHARED ?= n 62464718c93SJerome Forissier 62539ef71afSEtienne Carriereifeq (y-y,$(CFG_TA_GPROF_SUPPORT)-$(CFG_ULIBS_SHARED)) 62670aa7511SJerome Forissier$(error CFG_TA_GPROF_SUPPORT and CFG_ULIBS_SHARED are currently incompatible) 62770aa7511SJerome Forissierendif 62870aa7511SJerome Forissier 629cb0b5954SJens Wiklander# CFG_GP_SOCKETS 630cb0b5954SJens Wiklander# Enable Global Platform Sockets support 631cb0b5954SJens WiklanderCFG_GP_SOCKETS ?= y 63280a4e51dSEtienne Carriere 63380a4e51dSEtienne Carriere# Enable Secure Data Path support in OP-TEE core (TA may be invoked with 63480a4e51dSEtienne Carriere# invocation parameters referring to specific secure memories). 63580a4e51dSEtienne CarriereCFG_SECURE_DATA_PATH ?= n 63600da26ecSAndrew F. Davis 637c9720143SJens Wiklander# Enable storage for TAs in secure storage, depends on CFG_REE_FS=y 638c9720143SJens Wiklander# TA binaries are stored encrypted in the REE FS and are protected by 639c9720143SJens Wiklander# metadata in secure storage. 640c9720143SJens WiklanderCFG_SECSTOR_TA ?= $(call cfg-all-enabled,CFG_REE_FS CFG_WITH_USER_TA) 641c9720143SJens Wiklander$(eval $(call cfg-depends-all,CFG_SECSTOR_TA,CFG_REE_FS CFG_WITH_USER_TA)) 642c9720143SJens Wiklander 64330668b28SJens Wiklander# Enable the pseudo TA that managages TA storage in secure storage 64430668b28SJens WiklanderCFG_SECSTOR_TA_MGMT_PTA ?= $(call cfg-all-enabled,CFG_SECSTOR_TA) 64530668b28SJens Wiklander$(eval $(call cfg-depends-all,CFG_SECSTOR_TA_MGMT_PTA,CFG_SECSTOR_TA)) 646c9720143SJens Wiklander 6474bca302aSIgor Opaniuk# Enable the pseudo TA for misc. auxilary services, extending existing 64857e642f1SEtienne Carriere# GlobalPlatform TEE Internal Core API (for example, re-seeding RNG entropy 64957e642f1SEtienne Carriere# pool etc...) 65057e642f1SEtienne CarriereCFG_SYSTEM_PTA ?= $(CFG_WITH_USER_TA) 65157e642f1SEtienne Carriere$(eval $(call cfg-depends-all,CFG_SYSTEM_PTA,CFG_WITH_USER_TA)) 6524bca302aSIgor Opaniuk 6530b611081SSumit Garg# Enable the pseudo TA for enumeration of TEE based devices for the normal 6540b611081SSumit Garg# world OS. 6550b611081SSumit GargCFG_DEVICE_ENUM_PTA ?= y 6560b611081SSumit Garg 6577e05ec25SJerome Forissier# The attestation pseudo TA provides an interface to request measurements of 6587e05ec25SJerome Forissier# a TA or the TEE binary. 6597e05ec25SJerome ForissierCFG_ATTESTATION_PTA ?= n 6607e05ec25SJerome Forissier$(eval $(call cfg-depends-all,CFG_ATTESTATION_PTA,_CFG_WITH_SECURE_STORAGE)) 6617e05ec25SJerome Forissier 6627e05ec25SJerome Forissier# RSA key size (in bits) for the attestation PTA. Must be at least 528 given 6637e05ec25SJerome Forissier# other algorithm parameters (RSA PSS with SHA-256 and 32-byte salt), but 6647e05ec25SJerome Forissier# note that such a low value is not secure. 6657e05ec25SJerome Forissier# See https://tools.ietf.org/html/rfc8017#section-8.1.1 and 6667e05ec25SJerome Forissier# https://tools.ietf.org/html/rfc8017#section-9.1.1 6677e05ec25SJerome Forissier# emLen >= hlen + sLen + 2 = 32 + 32 + 2 = 66 6687e05ec25SJerome Forissier# emLen = ceil((modBits - 1) / 8) => emLen is the key size in bytes 6697e05ec25SJerome ForissierCFG_ATTESTATION_PTA_KEY_SIZE ?= 3072 6707e05ec25SJerome Forissier 67100da26ecSAndrew F. Davis# Define the number of cores per cluster used in calculating core position. 67200da26ecSAndrew F. Davis# The cluster number is shifted by this value and added to the core ID, 67300da26ecSAndrew F. Davis# so its value represents log2(cores/cluster). 67400da26ecSAndrew F. Davis# Default is 2**(2) = 4 cores per cluster. 67500da26ecSAndrew F. DavisCFG_CORE_CLUSTER_SHIFT ?= 2 676d81f93a7SVolodymyr Babchuk 6778be2de1aSImre Kis# Define the number of threads per core used in calculating processing 6788be2de1aSImre Kis# element's position. The core number is shifted by this value and added to 6798be2de1aSImre Kis# the thread ID, so its value represents log2(threads/core). 6808be2de1aSImre Kis# Default is 2**(0) = 1 threads per core. 6818be2de1aSImre KisCFG_CORE_THREAD_SHIFT ?= 0 6828be2de1aSImre Kis 68337a6b717SJens Wiklander# Enable support for dynamic shared memory (shared memory anywhere in 68437a6b717SJens Wiklander# non-secure memory). 68537a6b717SJens WiklanderCFG_CORE_DYN_SHM ?= y 68637a6b717SJens Wiklander 6878aeb6c94SJens Wiklander# Enable support for reserved shared memory (shared memory in a carved out 6888aeb6c94SJens Wiklander# memory area). 6898aeb6c94SJens WiklanderCFG_CORE_RESERVED_SHM ?= y 6908aeb6c94SJens Wiklander 691dd3afbacSJens Wiklander# Enables support for larger physical addresses, that is, it will define 692dd3afbacSJens Wiklander# paddr_t as a 64-bit type. 693dd3afbacSJens WiklanderCFG_CORE_LARGE_PHYS_ADDR ?= n 694e3458e03SJerome Forissier 695e3458e03SJerome Forissier# Define the maximum size, in bits, for big numbers in the Internal Core API 696e3458e03SJerome Forissier# Arithmetical functions. This does *not* influence the key size that may be 697e3458e03SJerome Forissier# manipulated through the Cryptographic API. 698e3458e03SJerome Forissier# Set this to a lower value to reduce the TA memory footprint. 699e3458e03SJerome ForissierCFG_TA_BIGNUM_MAX_BITS ?= 2048 700409d2ff0SJerome Forissier 701409d2ff0SJerome Forissier# Define the maximum size, in bits, for big numbers in the TEE core (privileged 702409d2ff0SJerome Forissier# layer). 703409d2ff0SJerome Forissier# This value is an upper limit for the key size in any cryptographic algorithm 704409d2ff0SJerome Forissier# implemented by the TEE core. 705409d2ff0SJerome Forissier# Set this to a lower value to reduce the memory footprint. 706409d2ff0SJerome ForissierCFG_CORE_BIGNUM_MAX_BITS ?= 4096 707a97bc4a0SJens Wiklander 7087fb525f1SJerome Forissier# Not used since libmpa was removed. Force the values to catch build scripts 7097fb525f1SJerome Forissier# that would set = n. 7107fb525f1SJerome Forissier$(call force,CFG_TA_MBEDTLS_MPI,y) 7117fb525f1SJerome Forissier$(call force,CFG_TA_MBEDTLS,y) 712a97bc4a0SJens Wiklander 713a97bc4a0SJens Wiklander# Compile the TA library mbedTLS with self test functions, the functions 714a97bc4a0SJens Wiklander# need to be called to test anything 715a97bc4a0SJens WiklanderCFG_TA_MBEDTLS_SELF_TEST ?= y 716017dfaf8SGabor Szekely 71768689d86SJens Wiklander# By default use tomcrypt as the main crypto lib providing an implementation 71868689d86SJens Wiklander# for the API in <crypto/crypto.h> 71968689d86SJens Wiklander# CFG_CRYPTOLIB_NAME is used as libname and 72068689d86SJens Wiklander# CFG_CRYPTOLIB_DIR is used as libdir when compiling the library 72177327d7aSEdison Ai# 72277327d7aSEdison Ai# It's also possible to configure to use mbedtls instead of tomcrypt. 72377327d7aSEdison Ai# Then the variables should be assigned as "CFG_CRYPTOLIB_NAME=mbedtls" and 72477327d7aSEdison Ai# "CFG_CRYPTOLIB_DIR=lib/libmbedtls" respectively. 72568689d86SJens WiklanderCFG_CRYPTOLIB_NAME ?= tomcrypt 72668689d86SJens WiklanderCFG_CRYPTOLIB_DIR ?= core/lib/libtomcrypt 72768689d86SJens Wiklander 7287fb525f1SJerome Forissier# Not used since libmpa was removed. Force the value to catch build scripts 7297fb525f1SJerome Forissier# that would set = n. 7307fb525f1SJerome Forissier$(call force,CFG_CORE_MBEDTLS_MPI,y) 7317fb525f1SJerome Forissier 73215216d4dSVolodymyr Babchuk# Enable virtualization support. OP-TEE will not work without compatible 73315216d4dSVolodymyr Babchuk# hypervisor if this option is enabled. 734b76b2296SJerome ForissierCFG_NS_VIRTUALIZATION ?= $(CFG_VIRTUALIZATION) 735b76b2296SJerome ForissierCFG_NS_VIRTUALIZATION ?= n 73615216d4dSVolodymyr Babchuk 737b76b2296SJerome Forissierifeq ($(CFG_NS_VIRTUALIZATION),y) 73815216d4dSVolodymyr Babchuk$(call force,CFG_CORE_RODATA_NOEXEC,y) 73915216d4dSVolodymyr Babchuk$(call force,CFG_CORE_RWDATA_NOEXEC,y) 740c4e8be26SVolodymyr Babchuk 741c4e8be26SVolodymyr Babchuk# Default number of virtual guests 742c4e8be26SVolodymyr BabchukCFG_VIRT_GUEST_COUNT ?= 2 74315216d4dSVolodymyr Babchukendif 74415216d4dSVolodymyr Babchuk 74517888736SJens Wiklander# Enables backwards compatible derivation of RPMB and SSK keys 74617888736SJens WiklanderCFG_CORE_HUK_SUBKEY_COMPAT ?= y 747a2087649SJerome Forissier 74833b38f8cSRuslan Piasetskyi# Use SoC specific tee_otp_get_die_id() implementation for SSK key generation. 74933b38f8cSRuslan Piasetskyi# This option depends on CFG_CORE_HUK_SUBKEY_COMPAT=y. 75033b38f8cSRuslan PiasetskyiCFG_CORE_HUK_SUBKEY_COMPAT_USE_OTP_DIE_ID ?= n 75133b38f8cSRuslan Piasetskyi 752a2087649SJerome Forissier# Compress and encode conf.mk into the TEE core, and show the encoded string on 753a2087649SJerome Forissier# boot (with severity TRACE_INFO). 754a2087649SJerome ForissierCFG_SHOW_CONF_ON_BOOT ?= n 755dd333f03SJavier Almansa Sobrino 756dd333f03SJavier Almansa Sobrino# Enables support for passing a TPM Event Log stored in secure memory 757145035ffSImre Kis# to a TA or FF-A SP, so a TPM Service could use it to extend any measurement 758dd333f03SJavier Almansa Sobrino# taken before the service was up and running. 759dd333f03SJavier Almansa SobrinoCFG_CORE_TPM_EVENT_LOG ?= n 760ae8c8068SEtienne Carriere 761ae8c8068SEtienne Carriere# When enabled, CFG_SCMI_MSG_DRIVERS embeds SCMI message drivers in the core. 762ae8c8068SEtienne Carriere# Refer to the supported SCMI features embedded upon CFG_SCMI_MSG_* 76328e51326SEtienne Carriere# 764a7a9e3baSEtienne Carriere# CFG_SCMI_MSG_CLOCK embeds SCMI clock protocol support. 76556a1f10eSEtienne Carriere# CFG_SCMI_MSG_RESET_DOMAIN embeds SCMI reset domain protocol support. 76628e51326SEtienne Carriere# CFG_SCMI_MSG_SMT embeds a SMT header in shared device memory buffers 767f37af03eSEtienne Carriere# CFG_SCMI_MSG_VOLTAGE_DOMAIN embeds SCMI voltage domain protocol support. 76828e51326SEtienne Carriere# CFG_SCMI_MSG_SMT_FASTCALL_ENTRY embeds fastcall SMC entry with SMT memory 76928e51326SEtienne Carriere# CFG_SCMI_MSG_SMT_INTERRUPT_ENTRY embeds interrupt entry with SMT memory 77028e51326SEtienne Carriere# CFG_SCMI_MSG_SMT_THREAD_ENTRY embeds threaded entry with SMT memory 771916cc52aSEtienne Carriere# CFG_SCMI_MSG_SHM_MSG embeds a MSG header in cached shared memory buffer 772ae8c8068SEtienne CarriereCFG_SCMI_MSG_DRIVERS ?= n 77328e51326SEtienne Carriereifeq ($(CFG_SCMI_MSG_DRIVERS),y) 774a7a9e3baSEtienne CarriereCFG_SCMI_MSG_CLOCK ?= n 77556a1f10eSEtienne CarriereCFG_SCMI_MSG_RESET_DOMAIN ?= n 776916cc52aSEtienne CarriereCFG_SCMI_MSG_SHM_MSG ?= n 777a58c4d70SEtienne CarriereCFG_SCMI_MSG_SMT ?= n 77828e51326SEtienne CarriereCFG_SCMI_MSG_SMT_FASTCALL_ENTRY ?= n 77928e51326SEtienne CarriereCFG_SCMI_MSG_SMT_INTERRUPT_ENTRY ?= n 78028e51326SEtienne CarriereCFG_SCMI_MSG_SMT_THREAD_ENTRY ?= n 78128e51326SEtienne CarriereCFG_SCMI_MSG_THREAD_ENTRY ?= n 782f37af03eSEtienne CarriereCFG_SCMI_MSG_VOLTAGE_DOMAIN ?= n 78328e51326SEtienne Carriere$(eval $(call cfg-depends-all,CFG_SCMI_MSG_SMT_FASTCALL_ENTRY,CFG_SCMI_MSG_SMT)) 78428e51326SEtienne Carriere$(eval $(call cfg-depends-all,CFG_SCMI_MSG_SMT_INTERRUPT_ENTRY,CFG_SCMI_MSG_SMT)) 785916cc52aSEtienne Carriere$(eval $(call cfg-depends-one,CFG_SCMI_MSG_SMT_THREAD_ENTRY,CFG_SCMI_MSG_SMT CFG_SCMI_MSG_SHM_MSG)) 78616a5030fSEtienne Carriereifeq ($(CFG_SCMI_MSG_SMT),y) 78716a5030fSEtienne Carriere_CFG_SCMI_PTA_SMT_HEADER := y 78816a5030fSEtienne Carriereendif 78916a5030fSEtienne Carriereifeq ($(CFG_SCMI_MSG_SHM_MSG),y) 79016a5030fSEtienne Carriere_CFG_SCMI_PTA_MSG_HEADER := y 79116a5030fSEtienne Carriereendif 79228e51326SEtienne Carriereendif 79342471ecfSJens Wiklander 7944c4212e9SVincent Guittot# CFG_SCMI_SCPFW, when enabled, embeds the reference SCMI server implementation 7954c4212e9SVincent Guittot# from SCP-firmware package as an built-in SCMI stack in core. This 7964c4212e9SVincent Guittot# configuration mandates target product identifier is configured with 7974c4212e9SVincent Guittot# CFG_SCMI_SCPFW_PRODUCT and the SCP-firmware source tree path with 7984c4212e9SVincent Guittot# CFG_SCP_FIRMWARE. 7994c4212e9SVincent GuittotCFG_SCMI_SCPFW ?= n 8004c4212e9SVincent Guittot 8014c4212e9SVincent Guittotifeq ($(CFG_SCMI_SCPFW),y) 8024c4212e9SVincent Guittot$(call force,CFG_SCMI_PTA,y,Required by CFG_SCMI_SCPFW) 8034c4212e9SVincent Guittotifeq (,$(CFG_SCMI_SCPFW_PRODUCT)) 8044c4212e9SVincent Guittot$(error CFG_SCMI_SCPFW=y requires CFG_SCMI_SCPFW_PRODUCT configuration) 8054c4212e9SVincent Guittotendif 8064c4212e9SVincent Guittotifeq (,$(wildcard $(CFG_SCP_FIRMWARE)/CMakeLists.txt)) 8074c4212e9SVincent Guittot$(error CFG_SCMI_SCPFW=y requires CFG_SCP_FIRMWARE configuration) 8084c4212e9SVincent Guittotendif 8094c4212e9SVincent Guittotendif #CFG_SCMI_SCPFW 8104c4212e9SVincent Guittot 8114c4212e9SVincent Guittotifeq ($(CFG_SCMI_MSG_DRIVERS)-$(CFG_SCMI_SCPFW),y-y) 8124c4212e9SVincent Guittot$(error CFG_SCMI_MSG_DRIVERS=y and CFG_SCMI_SCPFW=y are mutually exclusive) 8134c4212e9SVincent Guittotendif 8144c4212e9SVincent Guittot 815e80130f6SClément Léger# When enabled, CFG_SCMI_MSG_USE_CLK embeds SCMI clocks registering services for 816e80130f6SClément Léger# the platform SCMI server and implements the platform plat_scmi_clock_*() 817e80130f6SClément Léger# functions. 818e80130f6SClément LégerCFG_SCMI_MSG_USE_CLK ?= n 819e80130f6SClément Léger$(eval $(call cfg-depends-all,CFG_SCMI_MSG_USE_CLK,CFG_DRIVERS_CLK CFG_SCMI_MSG_DRIVERS)) 820e80130f6SClément Léger 821b0a1c250SEtienne Carriere# Enable SCMI PTA interface for REE SCMI agents 822b0a1c250SEtienne CarriereCFG_SCMI_PTA ?= n 82316a5030fSEtienne Carriereifeq ($(CFG_SCMI_PTA),y) 82416a5030fSEtienne Carriere_CFG_SCMI_PTA_SMT_HEADER ?= n 82516a5030fSEtienne Carriere_CFG_SCMI_PTA_MSG_HEADER ?= n 82616a5030fSEtienne Carriereendif 827b0a1c250SEtienne Carriere 82842471ecfSJens Wiklanderifneq ($(CFG_STMM_PATH),) 829f9cd31c5SJelle Sels$(call force,CFG_WITH_STMM_SP,y) 83042471ecfSJens Wiklanderelse 831f9cd31c5SJelle SelsCFG_WITH_STMM_SP ?= n 83242471ecfSJens Wiklanderendif 833f9cd31c5SJelle Selsifeq ($(CFG_WITH_STMM_SP),y) 83442471ecfSJens Wiklander$(call force,CFG_ZLIB,y) 83542471ecfSJens Wiklanderendif 8366915bbbbSJens Wiklander 8376915bbbbSJens Wiklander# When enabled checks that buffers passed to the GP Internal Core API 8386915bbbbSJens Wiklander# comply with the rules added as annotations as part of the definition of 8396915bbbbSJens Wiklander# the API. For example preventing buffers in non-secure shared memory when 8406915bbbbSJens Wiklander# not allowed. 8416915bbbbSJens WiklanderCFG_TA_STRICT_ANNOTATION_CHECKS ?= y 842c56cc686SJens Wiklander 843c56cc686SJens Wiklander# When enabled accepts the DES key sizes excluding parity bits as in 844c56cc686SJens Wiklander# the GP Internal API Specification v1.0 845c56cc686SJens WiklanderCFG_COMPAT_GP10_DES ?= y 846806a85faSJens Wiklander 847806a85faSJens Wiklander# Defines a limit for many levels TAs may call each others. 848806a85faSJens WiklanderCFG_CORE_MAX_SYSCALL_RECURSION ?= 4 849f2dad489SSergiy Kibrik 850f2dad489SSergiy Kibrik# Pseudo-TA to export hardware RNG output to Normal World 851f2dad489SSergiy Kibrik# RNG characteristics are platform specific 852f2dad489SSergiy KibrikCFG_HWRNG_PTA ?= n 853f2dad489SSergiy Kibrikifeq ($(CFG_HWRNG_PTA),y) 854f2dad489SSergiy Kibrik# Output rate of hw_get_random_bytes() in bytes per second, 0: not rate-limited 855f2dad489SSergiy KibrikCFG_HWRNG_RATE ?= 0 856f2dad489SSergiy Kibrik# Quality/entropy of hw_get_random_bytes() per 1024 bits of output data, in bits 857f2dad489SSergiy Kibrikifeq (,$(CFG_HWRNG_QUALITY)) 858f2dad489SSergiy Kibrik$(error CFG_HWRNG_QUALITY not defined) 859f2dad489SSergiy Kibrikendif 860f2dad489SSergiy Kibrikendif 86188876632SEtienne Carriere 86288876632SEtienne Carriere# CFG_PREALLOC_RPC_CACHE, when enabled, makes core to preallocate 86388876632SEtienne Carriere# shared memory for each secure thread. When disabled, RPC shared 86488876632SEtienne Carriere# memory is released once the secure thread has completed is execution. 86588876632SEtienne Carriereifeq ($(CFG_WITH_PAGER),y) 86688876632SEtienne CarriereCFG_PREALLOC_RPC_CACHE ?= n 86788876632SEtienne Carriereendif 86888876632SEtienne CarriereCFG_PREALLOC_RPC_CACHE ?= y 8692305544bSClément Léger 8702305544bSClément Léger# When enabled, CFG_DRIVERS_CLK embeds a clock framework in OP-TEE core. 8712305544bSClément Léger# This clock framework allows to describe clock tree and provides functions to 8722305544bSClément Léger# get and configure the clocks. 873dbe94a85SClément Léger# CFG_DRIVERS_CLK_DT embeds devicetree clock parsing support 874804e32d7SClément Léger# CFG_DRIVERS_CLK_FIXED add support for "fixed-clock" compatible clocks 87517fd9102SEtienne Carriere# CFG_DRIVERS_CLK_EARLY_PROBE makes clocks probed at early_init initcall level. 8762305544bSClément LégerCFG_DRIVERS_CLK ?= n 877dbe94a85SClément LégerCFG_DRIVERS_CLK_DT ?= $(call cfg-all-enabled,CFG_DRIVERS_CLK CFG_DT) 878804e32d7SClément LégerCFG_DRIVERS_CLK_FIXED ?= $(CFG_DRIVERS_CLK_DT) 87917fd9102SEtienne CarriereCFG_DRIVERS_CLK_EARLY_PROBE ?= $(CFG_DRIVERS_CLK_DT) 880dbe94a85SClément Léger 881d547c99aSEtienne Carriere$(eval $(call cfg-depends-all,CFG_DRIVERS_CLK_DT,CFG_DRIVERS_CLK CFG_DT)) 882d547c99aSEtienne Carriere$(eval $(call cfg-depends-all,CFG_DRIVERS_CLK_FIXED,CFG_DRIVERS_CLK_DT)) 883d547c99aSEtienne Carriere 884c78b2c66SEtienne Carriere# When enabled, CFG_DRIVERS_RSTCTRL embeds a reset controller framework in 885c78b2c66SEtienne Carriere# OP-TEE core to provide reset controls on subsystems of the devices. 886c78b2c66SEtienne CarriereCFG_DRIVERS_RSTCTRL ?= n 887c78b2c66SEtienne Carriere 8884fc179b6SThomas Perrot# When enabled, CFG_DRIVERS_GPIO embeds a GPIO controller framework in 8894fc179b6SThomas Perrot# OP-TEE core to provide GPIO support for drivers. 8904fc179b6SThomas PerrotCFG_DRIVERS_GPIO ?= n 8914fc179b6SThomas Perrot 8928bc9c9e2SClément Léger# When enabled, CFG_DRIVERS_I2C provides I2C controller and devices support. 8938bc9c9e2SClément LégerCFG_DRIVERS_I2C ?= n 8948bc9c9e2SClément Léger 8959aec039eSClément Léger# When enabled, CFG_DRIVERS_PINCTRL embeds a pin muxing controller framework in 8969aec039eSClément Léger# OP-TEE core to provide drivers a way to apply pin muxing configurations based 8979aec039eSClément Léger# on device-tree. 8989aec039eSClément LégerCFG_DRIVERS_PINCTRL ?= n 8999aec039eSClément Léger 9001a3d3273SEtienne Carriere# When enabled, CFG_DRIVERS_REGULATOR embeds a voltage regulator framework in 9016558b565SEtienne Carriere# OP-TEE core to provide drivers a common regulator interface and describe 9026558b565SEtienne Carriere# the regulators dependencies using an embedded device tree. 903652d2ce7SEtienne Carriere# 904652d2ce7SEtienne Carriere# When enabled, CFG_REGULATOR_FIXED embeds a voltage regulator driver for 905652d2ce7SEtienne Carriere# DT compatible "regulator-fixed" devices. 9061a3d3273SEtienne CarriereCFG_DRIVERS_REGULATOR ?= n 907652d2ce7SEtienne CarriereCFG_REGULATOR_FIXED ?= n 908652d2ce7SEtienne Carriere 909652d2ce7SEtienne Carriere$(eval $(call cfg-enable-all-depends,CFG_REGULATOR_FIXED, \ 910652d2ce7SEtienne Carriere CFG_DRIVERS_REGULATOR CFG_DT)) 9111a3d3273SEtienne Carriere 912*9ea709a7SEtienne Carriere# When enabled, CFG_INSECURE permits insecure configuration of OP-TEE core 913*9ea709a7SEtienne Carriere# and shows a print (info level) when booting up the device that 914*9ea709a7SEtienne Carriere# indicates that the board runs a standard developer configuration. 915*9ea709a7SEtienne Carriere# 916*9ea709a7SEtienne Carriere# A developer configuration doesn't necessarily have to be secure. The intention 9179e42008dSJoakim Bech# is that the one making products based on OP-TEE should override this flag in 9189e42008dSJoakim Bech# plat-xxx/conf.mk for the platform they're basing their products on after 9199e42008dSJoakim Bech# they've finalized implementing stubbed functionality (see OP-TEE 9209e42008dSJoakim Bech# documentation/Porting guidelines) as well as vendor specific security 9219e42008dSJoakim Bech# configuration. 922*9ea709a7SEtienne Carriere# 923*9ea709a7SEtienne Carriere# CFG_WARN_INSECURE served the same purpose as CFG_INSECURE but is deprecated. 924*9ea709a7SEtienne Carriereifneq (undefined,$(flavor CFG_WARN_INSECURE)) 925*9ea709a7SEtienne Carriere$(info WARNING: CFG_WARN_INSECURE is deprecated, use CFG_INSECURE instead) 926*9ea709a7SEtienne CarriereCFG_INSECURE ?= $(CFG_WARN_INSECURE) 927*9ea709a7SEtienne Carriereifneq ($(CFG_INSECURE),$(CFG_WARN_INSECURE)) 928*9ea709a7SEtienne Carriere$(error Inconsistent CFG_INSECURE=$(CFG_INSECURE) and CFG_WARN_INSECURE=$(CFG_WARN_INSECURE)) 929*9ea709a7SEtienne Carriereendif 930*9ea709a7SEtienne Carriereendif # CFG_WARN_INSECURE defined 931*9ea709a7SEtienne CarriereCFG_INSECURE ?= y 9329e42008dSJoakim Bech 933a748f9edSJens Wiklander# Enables warnings for declarations mixed with statements 934a748f9edSJens WiklanderCFG_WARN_DECL_AFTER_STATEMENT ?= y 935b7a623f8SRuchika Gupta 936b7a623f8SRuchika Gupta# Branch Target Identification (part of the ARMv8.5 Extensions) provides a 937b7a623f8SRuchika Gupta# mechanism to limit the set of locations to which computed branch instructions 938b7a623f8SRuchika Gupta# such as BR or BLR can jump. To make use of BTI in TEE core and ldelf on CPU's 939b7a623f8SRuchika Gupta# that support it, enable this option. A GCC toolchain built with 940b7a623f8SRuchika Gupta# --enable-standard-branch-protection is needed to use this option. 941b7a623f8SRuchika GuptaCFG_CORE_BTI ?= n 942b7a623f8SRuchika Gupta 943b7a623f8SRuchika Gupta$(eval $(call cfg-depends-all,CFG_CORE_BTI,CFG_ARM64_core)) 944b7a623f8SRuchika Gupta 945b7a623f8SRuchika Gupta# To make use of BTI in user space libraries and TA's on CPU's that support it, 946b7a623f8SRuchika Gupta# enable this option. 947b7a623f8SRuchika GuptaCFG_TA_BTI ?= $(CFG_CORE_BTI) 948b7a623f8SRuchika Gupta 949b7a623f8SRuchika Gupta$(eval $(call cfg-depends-all,CFG_TA_BTI,CFG_ARM64_core)) 950b7a623f8SRuchika Gupta 951b76b2296SJerome Forissierifeq (y-y,$(CFG_NS_VIRTUALIZATION)-$(call cfg-one-enabled, CFG_TA_BTI CFG_CORE_BTI)) 952b76b2296SJerome Forissier$(error CFG_NS_VIRTUALIZATION and BTI are currently incompatible) 953b7a623f8SRuchika Guptaendif 954b7a623f8SRuchika Gupta 955b7a623f8SRuchika Guptaifeq (y-y,$(CFG_PAGED_USER_TA)-$(CFG_TA_BTI)) 956b7a623f8SRuchika Gupta$(error CFG_PAGED_USER_TA and CFG_TA_BTI are currently incompatible) 957b7a623f8SRuchika Guptaendif 958c2d44948SJens Wiklander 959a0e8ffe9SJens Wiklander# Memory Tagging Extension (part of the ARMv8.5 Extensions) implements lock 960a0e8ffe9SJens Wiklander# and key access to memory. This is a hardware supported alternative to 961a0e8ffe9SJens Wiklander# CFG_CORE_SANITIZE_KADDRESS which covers both S-EL1 and S-EL0. 962a0e8ffe9SJens WiklanderCFG_MEMTAG ?= n 963a0e8ffe9SJens Wiklander 964a0e8ffe9SJens Wiklander$(eval $(call cfg-depends-all,CFG_MEMTAG,CFG_ARM64_core)) 965a0e8ffe9SJens Wiklanderifeq (y-y,$(CFG_CORE_SANITIZE_KADDRESS)-$(CFG_MEMTAG)) 966a0e8ffe9SJens Wiklander$(error CFG_CORE_SANITIZE_KADDRESS and CFG_MEMTAG are not compatible) 967a0e8ffe9SJens Wiklanderendif 968a0e8ffe9SJens Wiklanderifeq (y-y,$(CFG_WITH_PAGER)-$(CFG_MEMTAG)) 969a0e8ffe9SJens Wiklander$(error CFG_WITH_PAGER and CFG_MEMTAG are not compatible) 970a0e8ffe9SJens Wiklanderendif 971a0e8ffe9SJens Wiklander 9726fa59c9aSSeonghyun Park# Privileged Access Never (PAN, part of the ARMv8.1 Extensions) can be 9736fa59c9aSSeonghyun Park# used to restrict accesses to unprivileged memory from privileged mode. 9743db1b3e3SAlvin Chang# For RISC-V architecture, CSR {m|s}status.SUM bit is used to implement PAN. 9756fa59c9aSSeonghyun ParkCFG_PAN ?= n 9766fa59c9aSSeonghyun Park 9773db1b3e3SAlvin Chang$(eval $(call cfg-depends-one,CFG_PAN,CFG_ARM64_core CFG_RV64_core CFG_RV32_core)) 9786fa59c9aSSeonghyun Park 97923419643SEtienne Carriere# CFG_CORE_ASYNC_NOTIF is defined by the platform to enable support 980c2d44948SJens Wiklander# for sending asynchronous notifications to normal world. Note that an 981c2d44948SJens Wiklander# interrupt ID must be configurged by the platform too. Currently is only 982c2d44948SJens Wiklander# CFG_CORE_ASYNC_NOTIF_GIC_INTID defined. 983c2d44948SJens WiklanderCFG_CORE_ASYNC_NOTIF ?= n 984a51d45b5SJens Wiklander 985a51d45b5SJens Wiklander$(eval $(call cfg-enable-all-depends,CFG_MEMPOOL_REPORT_LAST_OFFSET, \ 986a51d45b5SJens Wiklander CFG_WITH_STATS)) 987bb329115SRuchika Gupta 98893dc6b29SJens Wiklander# Pointer Authentication (part of ARMv8.3 Extensions) provides instructions 98993dc6b29SJens Wiklander# for signing and authenticating pointers against secret keys. These can 99093dc6b29SJens Wiklander# be used to mitigate ROP (Return oriented programming) attacks. This is 99193dc6b29SJens Wiklander# currently done by instructing the compiler to add paciasp/autiasp at the 99293dc6b29SJens Wiklander# begging and end of functions to sign and verify ELR. 99393dc6b29SJens Wiklander# 99493dc6b29SJens Wiklander# The CFG_CORE_PAUTH enables these instructions for the core parts 99593dc6b29SJens Wiklander# executing at EL1, with one secret key per thread and one secret key per 99693dc6b29SJens Wiklander# physical CPU. 99793dc6b29SJens Wiklander# 99893dc6b29SJens Wiklander# The CFG_TA_PAUTH option enables these instructions for TA's at EL0. When 99993dc6b29SJens Wiklander# this option is enabled, TEE core will initialize secret keys per TA. 100093dc6b29SJens WiklanderCFG_CORE_PAUTH ?= n 100193dc6b29SJens WiklanderCFG_TA_PAUTH ?= $(CFG_CORE_PAUTH) 1002bb329115SRuchika Gupta 100393dc6b29SJens Wiklander$(eval $(call cfg-depends-all,CFG_CORE_PAUTH,CFG_ARM64_core)) 1004bb329115SRuchika Gupta$(eval $(call cfg-depends-all,CFG_TA_PAUTH,CFG_ARM64_core)) 10056b35a0abSRuchika Gupta 1006b76b2296SJerome Forissierifeq (y-y,$(CFG_NS_VIRTUALIZATION)-$(CFG_CORE_PAUTH)) 1007b76b2296SJerome Forissier$(error CFG_NS_VIRTUALIZATION and CFG_CORE_PAUTH are currently incompatible) 100893dc6b29SJens Wiklanderendif 1009b76b2296SJerome Forissierifeq (y-y,$(CFG_NS_VIRTUALIZATION)-$(CFG_TA_PAUTH)) 1010b76b2296SJerome Forissier$(error CFG_NS_VIRTUALIZATION and CFG_TA_PAUTH are currently incompatible) 10116b35a0abSRuchika Guptaendif 10126b35a0abSRuchika Gupta 10136b35a0abSRuchika Guptaifeq (y-y,$(CFG_TA_GPROF_SUPPORT)-$(CFG_TA_PAUTH)) 10146b35a0abSRuchika Gupta$(error CFG_TA_GPROF_SUPPORT and CFG_TA_PAUTH are currently incompatible) 10156b35a0abSRuchika Guptaendif 10166b35a0abSRuchika Gupta 10176b35a0abSRuchika Guptaifeq (y-y,$(CFG_FTRACE_SUPPORT)-$(CFG_TA_PAUTH)) 10186b35a0abSRuchika Gupta$(error CFG_FTRACE_SUPPORT and CFG_TA_PAUTH are currently incompatible) 10196b35a0abSRuchika Guptaendif 1020011a8f96SClément Léger 1021011a8f96SClément Léger# Enable support for generic watchdog registration 1022011a8f96SClément Léger# This watchdog will then be usable by non-secure world through SMC calls. 1023011a8f96SClément LégerCFG_WDT ?= n 1024cb60bce4SClément Léger 1025cb60bce4SClément Léger# Enable watchdog SMC handling compatible with arm-smc-wdt Linux driver 1026cb60bce4SClément LégerCFG_WDT_SM_HANDLER ?= n 1027cb60bce4SClément Léger 1028cb60bce4SClément Léger$(eval $(call cfg-enable-all-depends,CFG_WDT_SM_HANDLER,CFG_WDT)) 10297d3ac186SLionel Debieve 10307d3ac186SLionel Debieve# When CFG_WDT_SM_HANDLER=y, SMC function ID 0x82003D06 default implements 10317d3ac186SLionel Debieve# arm-smc-wdt service. Platform can also override this ID with a platform 10327d3ac186SLionel Debieve# specific SMC function ID to access arm-smc-wdt service thanks to 10337d3ac186SLionel Debieve# optional config switch CFG_WDT_SM_HANDLER_ID. 10347d3ac186SLionel DebieveCFG_WDT_SM_HANDLER_ID ?= 0x82003D06 103534d244bfSClément Léger 103634d244bfSClément Léger# Allow using the udelay/mdelay function for platforms without ARM generic timer 103734d244bfSClément Léger# extension. When set to 'n', the plat_get_freq() function must be defined by 103834d244bfSClément Léger# the platform code 103934d244bfSClément LégerCFG_CORE_HAS_GENERIC_TIMER ?= y 1040f3f9432fSClément Léger 1041f3f9432fSClément Léger# Enable RTC API 1042f3f9432fSClément LégerCFG_DRIVERS_RTC ?= n 1043cea1eb0bSClément Léger 1044cea1eb0bSClément Léger# Enable PTA for RTC access from non-secure world 1045cea1eb0bSClément LégerCFG_RTC_PTA ?= n 1046952f5260SRuchika Gupta 10471fdb1c4fSJelle Sels# Enable the FF-A SPMC tests in xtests 10481fdb1c4fSJelle SelsCFG_SPMC_TESTS ?= n 1049bfdeae23SJens Wiklander 1050bfdeae23SJens Wiklander# Allocate the translation tables needed to map the S-EL0 application 1051bfdeae23SJens Wiklander# loaded 1052bfdeae23SJens WiklanderCFG_CORE_PREALLOC_EL0_TBLS ?= n 1053bfdeae23SJens Wiklanderifeq (y-y,$(CFG_CORE_PREALLOC_EL0_TBLS)-$(CFG_WITH_PAGER)) 1054bfdeae23SJens Wiklander$(error "CFG_WITH_PAGER can't support CFG_CORE_PREALLOC_EL0_TBLS") 1055bfdeae23SJens Wiklanderendif 1056cb94c145SWeizhao Jiang 1057cb94c145SWeizhao Jiang# User TA runtime context dump. 1058cb94c145SWeizhao Jiang# When this option is enabled, OP-TEE provides a debug method for 1059cb94c145SWeizhao Jiang# developer to dump user TA's runtime context, including TA's heap stats. 1060cb94c145SWeizhao Jiang# Developer can open a stats PTA session and then invoke command 1061cb94c145SWeizhao Jiang# STATS_CMD_TA_STATS to get the context of loaded TAs. 1062cb94c145SWeizhao JiangCFG_TA_STATS ?= n 10637e75ca54SJens Wiklander 10647e75ca54SJens Wiklander# Enables best effort mitigations against fault injected when the hardware 10657e75ca54SJens Wiklander# is tampered with. Details in lib/libutils/ext/include/fault_mitigation.h 10667e75ca54SJens WiklanderCFG_FAULT_MITIGATION ?= y 10678bbc2e9cSJens Wiklander 1068c7f1b4f7SJens Wiklander# Enables TEE Internal Core API v1.1 compatibility for in-tree TAs. Note 1069c7f1b4f7SJens Wiklander# that this doesn't affect libutee itself, it's only the TAs compiled with 1070c7f1b4f7SJens Wiklander# this set that are affected. Each out-of-tree must set this if to enable 1071c7f1b4f7SJens Wiklander# compatibility with version v1.1 as the value of this variable is not 1072c7f1b4f7SJens Wiklander# preserved in the TA dev-kit. 1073c7f1b4f7SJens WiklanderCFG_TA_OPTEE_CORE_API_COMPAT_1_1 ?= n 10743d70a974SIgor Opaniuk 10753d70a974SIgor Opaniuk# Change supported HMAC key size range, from 64 to 1024. 10763d70a974SIgor Opaniuk# This is needed to pass AOSP Keymaster VTS tests: 10773d70a974SIgor Opaniuk# Link to tests : https://android.googlesource.com/platform/hardware/interfaces/+/master/keymaster/3.0/vts/functional/keymaster_hidl_hal_test.cpp 10783d70a974SIgor Opaniuk# Module: VtsHalKeymasterV3_0TargetTest 10793d70a974SIgor Opaniuk# Testcases: - PerInstance/SigningOperationsTest# 10803d70a974SIgor Opaniuk# - PerInstance/NewKeyGenerationTest# 10813d70a974SIgor Opaniuk# - PerInstance/ImportKeyTest# 10823d70a974SIgor Opaniuk# - PerInstance/EncryptionOperationsTest# 10833d70a974SIgor Opaniuk# - PerInstance/AttestationTest# 10843d70a974SIgor Opaniuk# Note that this violates GP requirements of HMAC size range. 10853d70a974SIgor OpaniukCFG_HMAC_64_1024_RANGE ?= n 1086aae97333Sloubaihui 1087aae97333Sloubaihui# Enable a hardware pbkdf2 function 1088aae97333Sloubaihui# By default use standard pbkdf2 implementation 1089aae97333SloubaihuiCFG_CRYPTO_HW_PBKDF2 ?= n 1090aae97333Sloubaihui$(eval $(call cfg-depends-all,CFG_CRYPTO_HW_PBKDF2,CFG_CRYPTO_PBKDF2)) 10912b719df0SGatien Chevallier 10922b719df0SGatien Chevallier# CFG_HALT_CORES_ON_PANIC, when enabled, makes any call to panic() halt the 10932b719df0SGatien Chevallier# other cores. The feature currently relies on GIC device to trap the other 10942b719df0SGatien Chevallier# cores using an SGI interrupt specified by CFG_HALT_CORES_ON_PANIC_SGI. 10952b719df0SGatien ChevallierCFG_HALT_CORES_ON_PANIC ?= n 10962b719df0SGatien ChevallierCFG_HALT_CORES_ON_PANIC_SGI ?= 15 10972b719df0SGatien Chevallier$(eval $(call cfg-depends-all,CFG_HALT_CORES_ON_PANIC,CFG_GIC)) 1098