blob: c70fd4731ed57ecd5ebbcfe07a45b5e6e34adb57 [file] [log] [blame]
Jerome Forissier120c43a2015-03-24 11:08:31 +01001# Default configuration values for OP-TEE core (all platforms).
2#
3# Platform-specific overrides are in core/arch/arm32/plat-*/conf.mk.
4# Some subsystem-specific defaults are not here but rather in */sub.mk.
5#
6# Configuration values may be assigned from multiple sources.
7# From higher to lower priority:
8#
9# 1. Make arguments ('make CFG_FOO=bar...')
10# 2. The file specified by $(CFG_OPTEE_CONFIG) (if defined)
11# 3. The environment ('CFG_FOO=bar make...')
12# 4. The platform-specific configuration file: core/arch/arm32/plat-*/conf.mk
13# 5. This file
14# 6. Subsystem-specific makefiles (*/sub.mk)
15#
Pascal Brandb5569a62016-01-08 15:14:30 +010016# Actual values used during the build are output to $(out-dir)/conf.mk
Jerome Forissier120c43a2015-03-24 11:08:31 +010017# (CFG_* variables only).
18
Jerome Forissiera75f2e12015-07-07 19:07:50 +020019# Cross-compiler prefix and suffix
20CROSS_COMPILE ?= arm-linux-gnueabihf-
Jerome Forissierc042fbe2016-02-05 10:48:36 +010021CROSS_COMPILE32 ?= $(CROSS_COMPILE)
22CROSS_COMPILE64 ?= aarch64-linux-gnu-
Jerome Forissiera75f2e12015-07-07 19:07:50 +020023COMPILER ?= gcc
24
Jerome Forissierb09cddc2016-02-24 13:01:45 +010025# For convenience
26ifdef CFLAGS
27CFLAGS32 ?= $(CFLAGS)
28CFLAGS64 ?= $(CFLAGS)
29endif
30
Jerome Forissier120c43a2015-03-24 11:08:31 +010031# Compiler warning level.
32# Supported values: undefined, 1, 2 and 3. 3 gives more warnings.
Pascal Brandb0104772014-06-12 15:56:20 +020033WARNS ?= 3
34
Dick Olssonb4faf482020-07-22 08:49:12 +020035# Path to the Python interpreter used by the build system.
36# This variable is set to the default python3 interpreter in the user's
37# path. But build environments that require more explicit control can
38# set the path to a specific interpreter through this variable.
39PYTHON3 ?= python3
40
Etienne Carriere3f17b832016-08-16 16:48:49 +020041# Define DEBUG=1 to compile without optimization (forces -O0)
Pascal Brandb0104772014-06-12 15:56:20 +020042# DEBUG=1
43
Jerome Forissier4ec23582017-06-13 10:15:33 +020044# If y, enable debug features of the TEE core (assertions and lock checks
45# are enabled, panic and assert messages are more verbose, data and prefetch
46# aborts show a stack dump). When disabled, the NDEBUG directive is defined
47# so assertions are disabled.
48CFG_TEE_CORE_DEBUG ?= y
Pascal Brandb0104772014-06-12 15:56:20 +020049
Ovidiu Mihalachi3f58e4e2018-11-05 12:05:51 +020050# Log levels for the TEE core. Defines which core messages are displayed
51# on the secure console. Disabling core log (level set to 0) also disables
52# logs from the TAs.
Jerome Forissier09ca9f82018-01-04 15:16:44 +010053# 0: none
54# 1: error
55# 2: error + warning
56# 3: error + warning + debug
57# 4: error + warning + debug + flow
Jerome Forissier120c43a2015-03-24 11:08:31 +010058CFG_TEE_CORE_LOG_LEVEL ?= 1
Ovidiu Mihalachi3f58e4e2018-11-05 12:05:51 +020059
60# TA log level
61# If user-mode library libutils.a is built with CFG_TEE_TA_LOG_LEVEL=0,
62# TA tracing is disabled regardless of the value of CFG_TEE_TA_LOG_LEVEL
63# when the TA is built.
Jerome Forissier120c43a2015-03-24 11:08:31 +010064CFG_TEE_TA_LOG_LEVEL ?= 1
Pascal Brandb0104772014-06-12 15:56:20 +020065
Jerome Forissier120c43a2015-03-24 11:08:31 +010066# TA enablement
67# When defined to "y", TA traces are output according to
68# CFG_TEE_TA_LOG_LEVEL. Otherwise, they are not output at all
69CFG_TEE_CORE_TA_TRACE ?= y
Pascal Brandb0104772014-06-12 15:56:20 +020070
Jerome Forissier8c8e1442018-02-21 10:00:49 +010071# If y, enable the memory leak detection feature in the bget memory allocator.
72# When this feature is enabled, calling mdbg_check(1) will print a list of all
73# the currently allocated buffers and the location of the allocation (file and
74# line number).
75# Note: make sure the log level is high enough for the messages to show up on
76# the secure console! For instance:
77# - To debug user-mode (TA) allocations: build OP-TEE *and* the TA with:
78# $ make CFG_TEE_TA_MALLOC_DEBUG=y CFG_TEE_TA_LOG_LEVEL=3
79# - To debug TEE core allocations: build OP-TEE with:
80# $ make CFG_TEE_CORE_MALLOC_DEBUG=y CFG_TEE_CORE_LOG_LEVEL=3
SY Chiu0fcbddd2015-11-11 19:10:42 +080081CFG_TEE_CORE_MALLOC_DEBUG ?= n
82CFG_TEE_TA_MALLOC_DEBUG ?= n
Jens Wiklanderc2ce4182019-04-12 10:36:41 +020083# Prints an error message and dumps the stack on failed memory allocations
84# using malloc() and friends.
85CFG_CORE_DUMP_OOM ?= $(CFG_TEE_CORE_MALLOC_DEBUG)
SY Chiu0fcbddd2015-11-11 19:10:42 +080086
Jerome Forissier2bfab752017-06-13 09:36:15 +020087# Mask to select which messages are prefixed with long debugging information
Volodymyr Babchuk64fad262018-05-23 18:58:04 +030088# (severity, core ID, thread ID, component name, function name, line number)
89# based on the message level. If BIT(level) is set, the long prefix is shown.
Jerome Forissier2bfab752017-06-13 09:36:15 +020090# Otherwise a short prefix is used (severity and component name only).
Jerome Forissierf4aa5b12015-05-12 18:06:22 +020091# Levels: 0=none 1=error 2=info 3=debug 4=flow
Jerome Forissier2bfab752017-06-13 09:36:15 +020092CFG_MSG_LONG_PREFIX_MASK ?= 0x1a
Jerome Forissierf4aa5b12015-05-12 18:06:22 +020093
Jerome Forissier120c43a2015-03-24 11:08:31 +010094# PRNG configuration
SY Chiu7018ae02015-03-04 15:04:45 +080095# If CFG_WITH_SOFTWARE_PRNG is enabled, crypto provider provided
96# software PRNG implementation is used.
SY Chiu7018ae02015-03-04 15:04:45 +080097# Otherwise, you need to implement hw_get_random_byte() for your platform
SY Chiu7018ae02015-03-04 15:04:45 +080098CFG_WITH_SOFTWARE_PRNG ?= y
Jerome Forissier120c43a2015-03-24 11:08:31 +010099
100# Number of threads
101CFG_NUM_THREADS ?= 2
Cedric Chaumontab35d7a2015-04-28 12:19:53 +0200102
103# API implementation version
104CFG_TEE_API_VERSION ?= GPD-1.1-dev
105
106# Implementation description (implementation-dependent)
107CFG_TEE_IMPL_DESCR ?= OPTEE
108
Jerome Forissier29cff5c2017-11-20 13:27:18 +0100109# Should OPTEE_SMC_CALL_GET_OS_REVISION return a build identifier to Normal
110# World?
111CFG_OS_REV_REPORTS_GIT_SHA1 ?= y
112
Cedric Chaumontab35d7a2015-04-28 12:19:53 +0200113# Trusted OS implementation version
Jens Wiklander4bf425c2015-12-21 15:06:08 +0100114TEE_IMPL_VERSION ?= $(shell git describe --always --dirty=-dev 2>/dev/null || echo Unknown)
Jerome Forissier29cff5c2017-11-20 13:27:18 +0100115ifeq ($(CFG_OS_REV_REPORTS_GIT_SHA1),y)
116TEE_IMPL_GIT_SHA1 := 0x$(shell git rev-parse --short=8 HEAD 2>/dev/null || echo 0)
117else
118TEE_IMPL_GIT_SHA1 := 0x0
119endif
Jerome Forissier35c507f2016-03-17 15:10:14 +0100120# The following values are not extracted from the "git describe" output because
121# we might be outside of a Git environment, or the tree may have been cloned
122# with limited depth not including any tag, so there is really no guarantee
123# that TEE_IMPL_VERSION contains the major and minor revision numbers.
Jerome Forissiera83aec22018-01-19 11:36:56 +0100124CFG_OPTEE_REVISION_MAJOR ?= 3
Jens Wiklander978f50b2020-05-25 12:20:08 +0200125CFG_OPTEE_REVISION_MINOR ?= 9
Cedric Chaumontab35d7a2015-04-28 12:19:53 +0200126
127# Trusted OS implementation manufacturer name
128CFG_TEE_MANUFACTURER ?= LINARO
129
130# Trusted firmware version
131CFG_TEE_FW_IMPL_VERSION ?= FW_IMPL_UNDEF
132
133# Trusted OS implementation manufacturer name
134CFG_TEE_FW_MANUFACTURER ?= FW_MAN_UNDEF
135
Jerome Forissierb44708c2016-04-18 09:35:34 +0200136# Rich Execution Environment (REE) file system support: normal world OS
137# provides the actual storage.
138# This is the default FS when enabled (i.e., the one used when
139# TEE_STORAGE_PRIVATE is passed to the trusted storage API)
140CFG_REE_FS ?= y
Jens Wiklanderbc420742015-05-05 14:59:15 +0200141
Jerome Forissier88e6e082016-01-27 17:38:21 +0100142# RPMB file system support
Jerome Forissier88e6e082016-01-27 17:38:21 +0100143CFG_RPMB_FS ?= n
144
145# Device identifier used when CFG_RPMB_FS = y.
146# The exact meaning of this value is platform-dependent. On Linux, the
147# tee-supplicant process will open /dev/mmcblk<id>rpmb
148CFG_RPMB_FS_DEV_ID ?= 0
149
Manuel Huber7d971592020-02-12 11:13:22 -0800150# This config variable determines the number of entries read in from RPMB at
151# once whenever a function traverses the RPMB FS. Increasing the default value
152# has the following consequences:
153# - More memory required on heap. A single FAT entry currently has a size of
154# 256 bytes.
155# - Potentially significant speed-ups for RPMB I/O. Depending on how many
156# entries a function needs to traverse, the number of time-consuming RPMB
157# read-in operations can be reduced.
158# Chosing a proper value is both platform- (available memory) and use-case-
159# dependent (potential number of FAT fs entries), so overwrite in platform
160# config files
161CFG_RPMB_FS_RD_ENTRIES ?= 8
162
Manuel Huber5f68d782020-03-17 11:24:30 -0700163# Enables caching of FAT FS entries when set to a value greater than zero.
164# When enabled, the cache stores the first 'CFG_RPMB_FS_CACHE_ENTRIES' FAT FS
165# entries. The cache is populated when FAT FS entries are initially read in.
166# When traversing the FAT FS entries, we read from the cache instead of reading
167# in the entries from RPMB storage. Consequently, when a FAT FS entry is
168# written, the cache is updated. In scenarios where an estimate of the number
169# of FAT FS entries can be made, the cache may be specifically tailored to
170# store all entries. The caching can improve RPMB I/O at the cost
171# of additional memory.
172# Without caching, we temporarily require
173# CFG_RPMB_FS_RD_ENTRIES*sizeof(struct rpmb_fat_entry) bytes of heap memory
174# while traversing the FAT FS (e.g. in read_fat).
175# For example 8*256 bytes = 2kB while in read_fat.
176# With caching, we constantly require up to
177# CFG_RPMB_FS_CACHE_ENTRIES*sizeof(struct rpmb_fat_entry) bytes of heap memory
178# depending on how many elements are in the cache, and additional temporary
179# CFG_RPMB_FS_RD_ENTRIES*sizeof(struct rpmb_fat_entry) bytes of heap memory
180# in case the cache is too small to hold all elements when traversing.
181CFG_RPMB_FS_CACHE_ENTRIES ?= 0
182
Jerome Forissiered1993b2017-01-23 12:44:58 +0100183# Enables RPMB key programming by the TEE, in case the RPMB partition has not
184# been configured yet.
185# !!! Security warning !!!
186# Do *NOT* enable this in product builds, as doing so would allow the TEE to
187# leak the RPMB key.
188# This option is useful in the following situations:
189# - Testing
190# - RPMB key provisioning in a controlled environment (factory setup)
191CFG_RPMB_WRITE_KEY ?= n
192
Jens Wiklanderbc420742015-05-05 14:59:15 +0200193# Embed public part of this key in OP-TEE OS
194TA_SIGN_KEY ?= keys/default_ta.pem
Jerome Forissierc4553de2015-11-25 09:40:18 +0100195
196# Include lib/libutils/isoc in the build? Most platforms need this, but some
197# may not because they obtain the isoc functions from elsewhere
198CFG_LIBUTILS_WITH_ISOC ?= y
Jens Wiklanderfce4cfa2015-12-10 15:30:07 +0100199
Jens Wiklander0de9a5f2015-12-11 16:35:10 +0100200# Enables floating point support for user TAs
201# ARM32: EABI defines both a soft-float ABI and a hard-float ABI,
202# hard-float is basically a super set of soft-float. Hard-float
203# requires all the support routines provided for soft-float, but the
204# compiler may choose to optimize to not use some of them and use
205# the floating-point registers instead.
206# ARM64: EABI doesn't define a soft-float ABI, everything is hard-float (or
207# nothing with ` -mgeneral-regs-only`)
208# With CFG_TA_FLOAT_SUPPORT enabled TA code is free use floating point types
209CFG_TA_FLOAT_SUPPORT ?= y
Jens Wiklander923c1f32015-12-06 11:01:54 +0100210
Jerome Forissier7411e0e2017-10-12 10:11:45 +0200211# Stack unwinding: print a stack dump to the console on core or TA abort, or
212# when a TA panics.
Jerome Forissier31a29642017-05-11 15:28:31 +0200213# If CFG_UNWIND is enabled, both the kernel and user mode call stacks can be
214# unwound (not paged TAs, however).
215# Note that 32-bit ARM code needs unwind tables for this to work, so enabling
216# this option will increase the size of the 32-bit TEE binary by a few KB.
217# Similarly, TAs have to be compiled with -funwind-tables (default when the
218# option is set) otherwise they can't be unwound.
Jerome Forissier7411e0e2017-10-12 10:11:45 +0200219# Warning: since the unwind sequence for user-mode (TA) code is implemented in
220# the privileged layer of OP-TEE, enabling this feature will weaken the
221# user/kernel isolation. Therefore it should be disabled in release builds.
Etienne Carriere3f17b832016-08-16 16:48:49 +0200222ifeq ($(CFG_TEE_CORE_DEBUG),y)
Jerome Forissier31a29642017-05-11 15:28:31 +0200223CFG_UNWIND ?= y
Jens Wiklander923c1f32015-12-06 11:01:54 +0100224endif
Jens Wiklander6fbac372015-11-05 14:22:05 +0100225
226# Enable support for dynamically loaded user TAs
227CFG_WITH_USER_TA ?= y
Jens Wiklander2a142242016-01-05 17:26:27 +0100228
Jerome Forissier24d49092018-12-17 17:43:48 +0100229# Choosing the architecture(s) of user-mode libraries (used by TAs)
230#
231# Platforms may define a list of supported architectures for user-mode code
232# by setting $(supported-ta-targets). Valid values are "ta_arm32", "ta_arm64",
233# "ta_arm32 ta_arm64" and "ta_arm64 ta_arm32".
234# $(supported-ta-targets) defaults to "ta_arm32" when the TEE core is 32-bits,
235# and "ta_arm32 ta_arm64" when it is 64-bits (that is, when CFG_ARM64_core=y).
236# The first entry in $(supported-ta-targets) has a special role, see
237# CFG_USER_TA_TARGET_<ta-name> below.
238#
239# CFG_USER_TA_TARGETS may be defined to restrict $(supported-ta-targets) or
240# change the order of the values.
241#
242# The list of TA architectures is ultimately stored in $(ta-targets).
243
244# CFG_USER_TA_TARGET_<ta-name> (for example, CFG_USER_TA_TARGET_avb), if
245# defined, selects the unique TA architecture mode for building the in-tree TA
246# <ta-name>. Can be either ta_arm32 or ta_arm64.
247# By default, in-tree TAs are built using the first architecture specified in
248# $(ta-targets).
249
Jerome Forissier7dfff132018-12-20 13:54:23 +0100250# Address Space Layout Randomization for user-mode Trusted Applications
251#
252# When this flag is enabled, the ELF loader will introduce a random offset
253# when mapping the application in user space. ASLR makes the exploitation of
254# memory corruption vulnerabilities more difficult.
Jens Wiklander87372da2019-11-22 14:02:00 +0100255CFG_TA_ASLR ?= y
Jerome Forissier7dfff132018-12-20 13:54:23 +0100256
257# How much ASLR may shift the base address (in pages). The base address is
258# randomly shifted by an integer number of pages comprised between these two
259# values. Bigger ranges are more secure because they make the addresses harder
260# to guess at the expense of using more memory for the page tables.
261CFG_TA_ASLR_MIN_OFFSET_PAGES ?= 0
262CFG_TA_ASLR_MAX_OFFSET_PAGES ?= 128
263
Jens Wiklander170e9082019-10-15 13:31:28 +0200264# Address Space Layout Randomization for TEE Core
265#
266# When this flag is enabled, the early init code will introduce a random
267# offset when mapping TEE Core. ASLR makes the exploitation of memory
268# corruption vulnerabilities more difficult.
Jens Wiklander87372da2019-11-22 14:02:00 +0100269CFG_CORE_ASLR ?= y
Jens Wiklander170e9082019-10-15 13:31:28 +0200270
Jerome Forissieree664c12017-05-05 15:42:00 +0200271# Load user TAs from the REE filesystem via tee-supplicant
Jerome Forissieree664c12017-05-05 15:42:00 +0200272CFG_REE_FS_TA ?= y
273
Jerome Forissier7db24ad2019-02-07 18:25:24 +0100274# Pre-authentication of TA binaries loaded from the REE filesystem
275#
276# - If CFG_REE_FS_TA_BUFFERED=y: load TA binary into a temporary buffer in the
277# "Secure DDR" pool, check the signature, then process the file only if it is
278# valid.
279# - If disabled: hash the binaries as they are being processed and verify the
280# signature as a last step.
Jerome Forissiere6e68742019-09-20 16:59:01 +0200281CFG_REE_FS_TA_BUFFERED ?= n
Jerome Forissier7db24ad2019-02-07 18:25:24 +0100282$(eval $(call cfg-depends-all,CFG_REE_FS_TA_BUFFERED,CFG_REE_FS_TA))
283
Jerome Forissierd0c63612017-07-25 18:17:11 +0200284# Support for loading user TAs from a special section in the TEE binary.
285# Such TAs are available even before tee-supplicant is available (hence their
286# name), but note that many services exported to TAs may need tee-supplicant,
287# so early use is limited to a subset of the TEE Internal Core API (crypto...)
288# To use this feature, set EARLY_TA_PATHS to the paths to one or more TA ELF
289# file(s). For example:
290# $ make ... \
291# EARLY_TA_PATHS="path/to/8aaaf200-2450-11e4-abe2-0002a5d5c51b.stripped.elf \
292# path/to/cb3e5ba0-adf1-11e0-998b-0002a5d5c51b.stripped.elf"
293# Typical build steps:
294# $ make ta_dev_kit CFG_EARLY_TA=y # Create the dev kit (user mode libraries,
295# # headers, makefiles), ready to build TAs.
296# # CFG_EARLY_TA=y is optional, it prevents
297# # later library recompilations.
298# <build some TAs>
299# $ make EARLY_TA_PATHS=<paths> # Build OP-TEE and embbed the TA(s)
Jens Wiklander3638ea32018-07-17 15:47:46 +0200300#
301# Another option is CFG_IN_TREE_EARLY_TAS which is used to point at
302# in-tree TAs. CFG_IN_TREE_EARLY_TAS is formatted as:
303# <name-of-ta>/<uuid>
304# for instance avb/023f8f1a-292a-432b-8fc4-de8471358067
305ifneq ($(EARLY_TA_PATHS)$(CFG_IN_TREE_EARLY_TAS),)
Jerome Forissierd0c63612017-07-25 18:17:11 +0200306$(call force,CFG_EARLY_TA,y)
307else
308CFG_EARLY_TA ?= n
309endif
Jerome Forissier509a9802017-08-01 10:14:57 +0200310ifeq ($(CFG_EARLY_TA),y)
311$(call force,CFG_ZLIB,y)
312endif
Jerome Forissierd0c63612017-07-25 18:17:11 +0200313
Jens Wiklandera884c932016-09-12 14:24:02 +0200314# Enable paging, requires SRAM, can't be enabled by default
315CFG_WITH_PAGER ?= n
316
Jerome Forissierab0df692018-10-15 16:43:03 +0200317# Runtime lock dependency checker: ensures that a proper locking hierarchy is
318# used in the TEE core when acquiring and releasing mutexes. Any violation will
319# cause a panic as soon as the invalid locking condition is detected. If
Jerome Forissier2288b072020-04-06 17:16:44 +0200320# CFG_UNWIND and CFG_LOCKDEP_RECORD_STACK are both enabled, the algorithm
321# records the call stacks when locks are taken, and prints them when a
322# potential deadlock is found.
Jerome Forissierab0df692018-10-15 16:43:03 +0200323# Expect a significant performance impact when enabling this.
324CFG_LOCKDEP ?= n
Jerome Forissier2288b072020-04-06 17:16:44 +0200325CFG_LOCKDEP_RECORD_STACK ?= y
Jerome Forissierab0df692018-10-15 16:43:03 +0200326
Joakim Bechbde8a252018-10-02 12:46:09 +0200327# BestFit algorithm in bget reduces the fragmentation of the heap when running
Jerome Forissierab0df692018-10-15 16:43:03 +0200328# with the pager enabled or lockdep
329CFG_CORE_BGET_BESTFIT ?= $(call cfg-one-enabled, CFG_WITH_PAGER CFG_LOCKDEP)
Joakim Bechbde8a252018-10-02 12:46:09 +0200330
Jens Wiklandera884c932016-09-12 14:24:02 +0200331# Use the pager for user TAs
332CFG_PAGED_USER_TA ?= $(CFG_WITH_PAGER)
333
Jens Wiklanderbe715232016-05-15 14:13:52 +0200334# Enable support for detected undefined behavior in C
Jens Wiklander1d171f92016-08-30 14:02:25 +0200335# Uses a lot of memory, can't be enabled by default
Jens Wiklanderbe715232016-05-15 14:13:52 +0200336CFG_CORE_SANITIZE_UNDEFINED ?= n
Jens Wiklanderb908c672016-05-25 14:01:53 +0200337
Jens Wiklander1d171f92016-08-30 14:02:25 +0200338# Enable Kernel Address sanitizer, has a huge performance impact, uses a
339# lot of memory and need platform specific adaptations, can't be enabled by
340# default
341CFG_CORE_SANITIZE_KADDRESS ?= n
342
Jerome Forissier35e770d2020-06-04 16:38:16 +0200343# Add stack guards before/after stacks and periodically check them
344CFG_WITH_STACK_CANARIES ?= y
345
Jerome Forissiere2f03e02020-06-04 16:44:57 +0200346# Use compiler instrumentation to troubleshoot stack overflows.
347# When enabled, most C functions check the stack pointer against the current
348# stack limits on entry and panic immediately if it is out of range.
349CFG_CORE_DEBUG_CHECK_STACKS ?= n
350
Jens Wiklanderb908c672016-05-25 14:01:53 +0200351# Device Tree support
Etienne Carrierec95b9512018-11-23 18:07:01 +0100352#
353# When CFG_DT is enabled core embeds the FDT library (libfdt) allowing
354# device tree blob (DTB) parsing from the core.
355#
356# When CFG_DT is enabled, the TEE _start function expects to find
357# the address of a DTB in register X2/R2 provided by the early boot stage
358# or value 0 if boot stage provides no DTB.
359#
360# When CFG_EMBED_DTB is enabled, CFG_EMBED_DTB_SOURCE_FILE shall define the
361# relative path of a DTS file located in core/arch/$(ARCH)/dts.
362# The DTS file is compiled into a DTB file which content is embedded in a
363# read-only section of the core.
364ifneq ($(strip $(CFG_EMBED_DTB_SOURCE_FILE)),)
365CFG_EMBED_DTB ?= y
366endif
367ifeq ($(CFG_EMBED_DTB),y)
368$(call force,CFG_DT,y)
369endif
370CFG_EMBED_DTB ?= n
Jens Wiklanderb908c672016-05-25 14:01:53 +0200371CFG_DT ?= n
Jens Wiklander76358be2016-05-25 21:42:02 +0200372
373# Maximum size of the Device Tree Blob, has to be large enough to allow
374# editing of the supplied DTB.
375CFG_DTB_MAX_SIZE ?= 0x10000
Victor Chong4d62e912016-08-16 17:16:33 +0100376
Bryan O'Donoghue0a3ad9b2018-11-19 14:18:30 +0000377# Device Tree Overlay support.
378# This define enables support for an OP-TEE provided DTB overlay.
379# One of two modes is supported in this case:
380# 1. Append OP-TEE nodes to an existing DTB overlay located at CFG_DT_ADDR or
381# passed in arg2
382# 2. Generate a new DTB overlay at CFG_DT_ADDR
383# A subsequent boot stage must then merge the generated overlay DTB into a main
384# DTB using the standard fdt_overlay_apply() method.
385CFG_EXTERNAL_DTB_OVERLAY ?= n
386
Etienne Carriere35964dc2018-04-05 16:38:08 +0200387# Enable core self tests and related pseudo TAs
Victor Chong4d62e912016-08-16 17:16:33 +0100388CFG_TEE_CORE_EMBED_INTERNAL_TESTS ?= y
yanyan-wrs6d96f202016-08-19 15:06:25 +0800389
390# This option enables OP-TEE to respond to SMP boot request: the Rich OS
391# issues this to request OP-TEE to release secondaries cores out of reset,
392# with specific core number and non-secure entry address.
393CFG_BOOT_SECONDARY_REQUEST ?= n
394
Jens Wiklanderf5f914a2016-09-27 11:37:05 -0700395# Default heap size for Core, 64 kB
396CFG_CORE_HEAP_SIZE ?= 65536
Jerome Forissierf3bb2312016-10-13 16:27:05 +0200397
Volodymyr Babchuk386fc262018-02-05 21:29:05 +0200398# Default size of nexus heap. 16 kB. Used only if CFG_VIRTUALIZATION
399# is enabled
400CFG_CORE_NEX_HEAP_SIZE ?= 16384
401
Jerome Forissier883c4be2016-10-13 15:21:53 +0200402# TA profiling.
403# When this option is enabled, OP-TEE can execute Trusted Applications
404# instrumented with GCC's -pg flag and will output profiling information
405# in gmon.out format to /tmp/gmon-<ta_uuid>.out (path is defined in
406# tee-supplicant)
Jerome Forissier8800b012019-11-08 17:55:24 +0100407# Note: this does not work well with shared libraries at the moment for a
408# couple of reasons:
409# 1. The profiling code assumes a unique executable section in the TA VA space.
410# 2. The code used to detect at run time if the TA is intrumented assumes that
411# the TA is linked statically.
Jerome Forissier883c4be2016-10-13 15:21:53 +0200412CFG_TA_GPROF_SUPPORT ?= n
Jerome Forissierf3bb2312016-10-13 16:27:05 +0200413
Sumit Gargb02ae382019-05-22 14:41:59 +0530414# TA function tracing.
415# When this option is enabled, OP-TEE can execute Trusted Applications
416# instrumented with GCC's -pg flag and will output function tracing
417# information in ftrace.out format to /tmp/ftrace-<ta_uuid>.out (path is
418# defined in tee-supplicant)
Sumit Garg099918f2019-09-05 13:23:01 +0530419CFG_FTRACE_SUPPORT ?= n
Sumit Gargb02ae382019-05-22 14:41:59 +0530420
Jerome Forissierd408db92020-02-12 10:29:13 +0100421# How to make room when the function tracing buffer is full?
422# 'shift': shift the previously stored data by the amount needed in order
423# to always keep the latest logs (slower, especially with big buffer sizes)
424# 'wrap': discard the previous data and start at the beginning of the buffer
425# again (fast, but can result in a mostly empty buffer)
426# 'stop': stop logging new data
427CFG_FTRACE_BUF_WHEN_FULL ?= shift
428$(call cfg-check-value,FTRACE_BUF_WHEN_FULL,shift stop wrap)
429$(call force,_CFG_FTRACE_BUF_WHEN_FULL_$(CFG_FTRACE_BUF_WHEN_FULL),y)
430
Jerome Forissierd1492092019-08-29 16:33:14 +0200431# Function tracing: unit to be used when displaying durations
432# 0: always display durations in microseconds
433# >0: if duration is greater or equal to the specified value (in microseconds),
434# display it in milliseconds
435CFG_FTRACE_US_MS ?= 10000
436
Sumit Garg099918f2019-09-05 13:23:01 +0530437# Core syscall function tracing.
438# When this option is enabled, OP-TEE core is instrumented with GCC's
439# -pg flag and will output syscall function graph in user TA ftrace
440# buffer
441CFG_SYSCALL_FTRACE ?= n
442$(call cfg-depends-all,CFG_SYSCALL_FTRACE,CFG_FTRACE_SUPPORT)
443
Jerome Forissier883c4be2016-10-13 15:21:53 +0200444# Enable to compile user TA libraries with profiling (-pg).
Sumit Garg099918f2019-09-05 13:23:01 +0530445# Depends on CFG_TA_GPROF_SUPPORT or CFG_FTRACE_SUPPORT.
Sumit Garg735565d2019-05-16 18:49:30 +0530446CFG_ULIBS_MCOUNT ?= n
Jerome Forissier0f8adaf2019-08-29 16:23:49 +0200447# Profiling/tracing of syscall wrapper (utee_*)
448CFG_SYSCALL_WRAPPERS_MCOUNT ?= $(CFG_ULIBS_MCOUNT)
Jerome Forissier883c4be2016-10-13 15:21:53 +0200449
Jerome Forissier0f8adaf2019-08-29 16:23:49 +0200450ifeq (y,$(filter y,$(CFG_ULIBS_MCOUNT) $(CFG_SYSCALL_WRAPPERS_MCOUNT)))
Sumit Garg099918f2019-09-05 13:23:01 +0530451ifeq (,$(filter y,$(CFG_TA_GPROF_SUPPORT) $(CFG_FTRACE_SUPPORT)))
Jerome Forissier883c4be2016-10-13 15:21:53 +0200452$(error Cannot instrument user libraries if user mode profiling is disabled)
Jerome Forissierf3bb2312016-10-13 16:27:05 +0200453endif
454endif
Jens Wiklandercb0b5952016-12-13 20:38:38 +0100455
Jerome Forissier7fb525f2020-01-23 18:24:14 +0100456# Build libutee, libutils, libmbedtls as shared libraries.
Jerome Forissier64718c92018-05-29 18:03:11 +0200457# - Static libraries are still generated when this is enabled, but TAs will use
458# the shared libraries unless explicitly linked with the -static flag.
459# - Shared libraries are made of two files: for example, libutee is
460# libutee.so and 527f1a47-b92c-4a74-95bd-72f19f4a6f74.ta. The '.so' file
461# is a totally standard shared object, and should be used to link against.
462# The '.ta' file is a signed version of the '.so' and should be installed
463# in the same way as TAs so that they can be found at runtime.
464CFG_ULIBS_SHARED ?= n
465
Jerome Forissier70aa7512019-05-02 13:34:08 +0200466ifeq (yy,$(CFG_TA_GPROF_SUPPORT)$(CFG_ULIBS_SHARED))
Jerome Forissier70aa7512019-05-02 13:34:08 +0200467$(error CFG_TA_GPROF_SUPPORT and CFG_ULIBS_SHARED are currently incompatible)
468endif
469
Jens Wiklandercb0b5952016-12-13 20:38:38 +0100470# CFG_GP_SOCKETS
471# Enable Global Platform Sockets support
472CFG_GP_SOCKETS ?= y
Etienne Carriere80a4e512017-03-17 12:48:19 +0100473
474# Enable Secure Data Path support in OP-TEE core (TA may be invoked with
475# invocation parameters referring to specific secure memories).
476CFG_SECURE_DATA_PATH ?= n
Andrew F. Davis00da26e2017-09-19 14:18:26 -0500477
Jens Wiklanderc9720142017-11-28 16:59:16 +0100478# Enable storage for TAs in secure storage, depends on CFG_REE_FS=y
479# TA binaries are stored encrypted in the REE FS and are protected by
480# metadata in secure storage.
481CFG_SECSTOR_TA ?= $(call cfg-all-enabled,CFG_REE_FS CFG_WITH_USER_TA)
482$(eval $(call cfg-depends-all,CFG_SECSTOR_TA,CFG_REE_FS CFG_WITH_USER_TA))
483
Jens Wiklander30668b22017-11-28 16:59:16 +0100484# Enable the pseudo TA that managages TA storage in secure storage
485CFG_SECSTOR_TA_MGMT_PTA ?= $(call cfg-all-enabled,CFG_SECSTOR_TA)
486$(eval $(call cfg-depends-all,CFG_SECSTOR_TA_MGMT_PTA,CFG_SECSTOR_TA))
Jens Wiklanderc9720142017-11-28 16:59:16 +0100487
Igor Opaniuk4bca3022018-05-22 16:29:49 +0300488# Enable the pseudo TA for misc. auxilary services, extending existing
489# GlobalPlatform Core API (for example, re-seeding RNG entropy pool etc.)
490CFG_SYSTEM_PTA ?= y
491
Sumit Garg0b611082019-01-07 18:46:15 +0530492# Enable the pseudo TA for enumeration of TEE based devices for the normal
493# world OS.
494CFG_DEVICE_ENUM_PTA ?= y
495
Andrew F. Davis00da26e2017-09-19 14:18:26 -0500496# Define the number of cores per cluster used in calculating core position.
497# The cluster number is shifted by this value and added to the core ID,
498# so its value represents log2(cores/cluster).
499# Default is 2**(2) = 4 cores per cluster.
500CFG_CORE_CLUSTER_SHIFT ?= 2
Volodymyr Babchukd81f93a2017-10-10 17:44:23 +0300501
Imre Kis8be2de12019-09-23 18:12:39 +0200502# Define the number of threads per core used in calculating processing
503# element's position. The core number is shifted by this value and added to
504# the thread ID, so its value represents log2(threads/core).
505# Default is 2**(0) = 1 threads per core.
506CFG_CORE_THREAD_SHIFT ?= 0
507
Jens Wiklander37a6b712019-04-18 08:56:31 +0200508# Enable support for dynamic shared memory (shared memory anywhere in
509# non-secure memory).
510CFG_CORE_DYN_SHM ?= y
511
Jens Wiklander8aeb6c92019-04-18 10:04:16 +0200512# Enable support for reserved shared memory (shared memory in a carved out
513# memory area).
514CFG_CORE_RESERVED_SHM ?= y
515
Jens Wiklanderdd3afba2017-10-05 23:10:33 +0200516# Enables support for larger physical addresses, that is, it will define
517# paddr_t as a 64-bit type.
518CFG_CORE_LARGE_PHYS_ADDR ?= n
Jerome Forissiere3458e02018-03-26 18:31:23 +0200519
520# Define the maximum size, in bits, for big numbers in the Internal Core API
521# Arithmetical functions. This does *not* influence the key size that may be
522# manipulated through the Cryptographic API.
523# Set this to a lower value to reduce the TA memory footprint.
524CFG_TA_BIGNUM_MAX_BITS ?= 2048
Jerome Forissier409d2ff2018-03-27 00:16:38 +0800525
526# Define the maximum size, in bits, for big numbers in the TEE core (privileged
527# layer).
528# This value is an upper limit for the key size in any cryptographic algorithm
529# implemented by the TEE core.
530# Set this to a lower value to reduce the memory footprint.
531CFG_CORE_BIGNUM_MAX_BITS ?= 4096
Jens Wiklandera97bc4a2018-05-18 15:49:22 +0200532
Jerome Forissier7fb525f2020-01-23 18:24:14 +0100533# Not used since libmpa was removed. Force the values to catch build scripts
534# that would set = n.
535$(call force,CFG_TA_MBEDTLS_MPI,y)
536$(call force,CFG_TA_MBEDTLS,y)
Jens Wiklandera97bc4a2018-05-18 15:49:22 +0200537
538# Compile the TA library mbedTLS with self test functions, the functions
539# need to be called to test anything
540CFG_TA_MBEDTLS_SELF_TEST ?= y
Gabor Szekely017dfaf2018-11-13 09:05:42 +0000541
Jens Wiklander68689d82019-03-25 18:31:11 +0100542# By default use tomcrypt as the main crypto lib providing an implementation
543# for the API in <crypto/crypto.h>
544# CFG_CRYPTOLIB_NAME is used as libname and
545# CFG_CRYPTOLIB_DIR is used as libdir when compiling the library
Edison Ai77327d72017-12-15 16:38:30 +0800546#
547# It's also possible to configure to use mbedtls instead of tomcrypt.
548# Then the variables should be assigned as "CFG_CRYPTOLIB_NAME=mbedtls" and
549# "CFG_CRYPTOLIB_DIR=lib/libmbedtls" respectively.
Jens Wiklander68689d82019-03-25 18:31:11 +0100550CFG_CRYPTOLIB_NAME ?= tomcrypt
551CFG_CRYPTOLIB_DIR ?= core/lib/libtomcrypt
552
Gabor Szekely017dfaf2018-11-13 09:05:42 +0000553# Enable TEE_ALG_RSASSA_PKCS1_V1_5 algorithm for signing with PKCS#1 v1.5 EMSA
Jens Wiklander68689d82019-03-25 18:31:11 +0100554# without ASN.1 around the hash.
555ifeq ($(CFG_CRYPTOLIB_NAME),tomcrypt)
Gabor Szekely017dfaf2018-11-13 09:05:42 +0000556CFG_CRYPTO_RSASSA_NA1 ?= y
Jens Wiklander68689d82019-03-25 18:31:11 +0100557endif
Volodymyr Babchuk15216d42018-02-06 19:35:07 +0200558
Jerome Forissier7fb525f2020-01-23 18:24:14 +0100559# Not used since libmpa was removed. Force the value to catch build scripts
560# that would set = n.
561$(call force,CFG_CORE_MBEDTLS_MPI,y)
562
Volodymyr Babchuk15216d42018-02-06 19:35:07 +0200563# Enable virtualization support. OP-TEE will not work without compatible
564# hypervisor if this option is enabled.
565CFG_VIRTUALIZATION ?= n
566
567ifeq ($(CFG_VIRTUALIZATION),y)
568$(call force,CFG_CORE_RODATA_NOEXEC,y)
569$(call force,CFG_CORE_RWDATA_NOEXEC,y)
Volodymyr Babchukc4e8be22018-05-30 23:24:07 +0300570
571# Default number of virtual guests
572CFG_VIRT_GUEST_COUNT ?= 2
Volodymyr Babchuk15216d42018-02-06 19:35:07 +0200573endif
574
Jens Wiklander17888732019-04-25 15:59:17 +0200575# Enables backwards compatible derivation of RPMB and SSK keys
576CFG_CORE_HUK_SUBKEY_COMPAT ?= y
Jerome Forissiera2087642019-09-18 18:03:43 +0200577
578# Compress and encode conf.mk into the TEE core, and show the encoded string on
579# boot (with severity TRACE_INFO).
580CFG_SHOW_CONF_ON_BOOT ?= n
Javier Almansa Sobrinodd333f02020-01-20 14:03:29 +0000581
582# Enables support for passing a TPM Event Log stored in secure memory
583# to a TA, so a TPM Service could use it to extend any measurement
584# taken before the service was up and running.
585CFG_CORE_TPM_EVENT_LOG ?= n
Etienne Carriereae8c8062019-12-01 21:57:35 +0100586
587# When enabled, CFG_SCMI_MSG_DRIVERS embeds SCMI message drivers in the core.
588# Refer to the supported SCMI features embedded upon CFG_SCMI_MSG_*
Etienne Carrierea7a9e3b2019-12-02 02:34:56 +0100589# CFG_SCMI_MSG_CLOCK embeds SCMI clock protocol support.
Etienne Carriere56a1f102019-12-02 02:36:07 +0100590# CFG_SCMI_MSG_RESET_DOMAIN embeds SCMI reset domain protocol support.
Etienne Carrierea58c4d72019-12-16 11:44:01 +0100591# CFG_SCMI_MSG_SMT embeds SMT based message buffer of communication channel
Etienne Carriereae8c8062019-12-01 21:57:35 +0100592CFG_SCMI_MSG_DRIVERS ?= n
Etienne Carrierea7a9e3b2019-12-02 02:34:56 +0100593CFG_SCMI_MSG_CLOCK ?= n
Etienne Carriere56a1f102019-12-02 02:36:07 +0100594CFG_SCMI_MSG_RESET_DOMAIN ?= n
Etienne Carrierea58c4d72019-12-16 11:44:01 +0100595CFG_SCMI_MSG_SMT ?= n