xref: /optee_os/mk/config.mk (revision 42d2ab27f8c057b5b6e952ab0ec802516a255b4a)
1# 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#
16# Actual values used during the build are output to $(out-dir)/conf.mk
17# (CFG_* variables only).
18
19# Cross-compiler prefix and suffix
20CROSS_COMPILE ?= arm-linux-gnueabihf-
21CROSS_COMPILE32 ?= $(CROSS_COMPILE)
22CROSS_COMPILE64 ?= aarch64-linux-gnu-
23COMPILER ?= gcc
24
25# For convenience
26ifdef CFLAGS
27CFLAGS32 ?= $(CFLAGS)
28CFLAGS64 ?= $(CFLAGS)
29endif
30
31# Compiler warning level.
32# Supported values: undefined, 1, 2 and 3. 3 gives more warnings.
33WARNS ?= 3
34
35# 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
41# Define DEBUG=1 to compile without optimization (forces -O0)
42# DEBUG=1
43
44# 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
49
50# 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.
53# 0: none
54# 1: error
55# 2: error + warning
56# 3: error + warning + debug
57# 4: error + warning + debug + flow
58CFG_TEE_CORE_LOG_LEVEL ?= 1
59
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.
64CFG_TEE_TA_LOG_LEVEL ?= 1
65
66# 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
70
71# 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
81CFG_TEE_CORE_MALLOC_DEBUG ?= n
82CFG_TEE_TA_MALLOC_DEBUG ?= n
83# 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)
86
87# Mask to select which messages are prefixed with long debugging information
88# (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.
90# Otherwise a short prefix is used (severity and component name only).
91# Levels: 0=none 1=error 2=info 3=debug 4=flow
92CFG_MSG_LONG_PREFIX_MASK ?= 0x1a
93
94# PRNG configuration
95# If CFG_WITH_SOFTWARE_PRNG is enabled, crypto provider provided
96# software PRNG implementation is used.
97# Otherwise, you need to implement hw_get_random_byte() for your platform
98CFG_WITH_SOFTWARE_PRNG ?= y
99
100# Number of threads
101CFG_NUM_THREADS ?= 2
102
103# API implementation version
104CFG_TEE_API_VERSION ?= GPD-1.1-dev
105
106# Implementation description (implementation-dependent)
107CFG_TEE_IMPL_DESCR ?= OPTEE
108
109# Should OPTEE_SMC_CALL_GET_OS_REVISION return a build identifier to Normal
110# World?
111CFG_OS_REV_REPORTS_GIT_SHA1 ?= y
112
113# Trusted OS implementation version
114TEE_IMPL_VERSION ?= $(shell git describe --always --dirty=-dev 2>/dev/null || echo Unknown)
115ifeq ($(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
120# 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.
124CFG_OPTEE_REVISION_MAJOR ?= 3
125CFG_OPTEE_REVISION_MINOR ?= 13
126
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
136# 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
141
142# RPMB file system support
143CFG_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
150# 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
163# 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
183# Print RPMB data frames sent to and received from the RPMB device
184CFG_RPMB_FS_DEBUG_DATA ?= n
185
186# Clear RPMB content at cold boot
187CFG_RPMB_RESET_FAT ?= n
188
189# Use a hard coded RPMB key instead of deriving it from the platform HUK
190CFG_RPMB_TESTKEY ?= n
191
192# Enables RPMB key programming by the TEE, in case the RPMB partition has not
193# been configured yet.
194# !!! Security warning !!!
195# Do *NOT* enable this in product builds, as doing so would allow the TEE to
196# leak the RPMB key.
197# This option is useful in the following situations:
198# - Testing
199# - RPMB key provisioning in a controlled environment (factory setup)
200CFG_RPMB_WRITE_KEY ?= n
201
202# Signing key for OP-TEE TA's
203# When performing external HSM signing for TA's TA_SIGN_KEY can be set to dummy
204# key and then set TA_PUBLIC_KEY to match public key from the HSM.
205# TA_PUBLIC_KEY's public key will be embedded into OP-TEE OS.
206TA_SIGN_KEY ?= keys/default_ta.pem
207TA_PUBLIC_KEY ?= $(TA_SIGN_KEY)
208
209# Include lib/libutils/isoc in the build? Most platforms need this, but some
210# may not because they obtain the isoc functions from elsewhere
211CFG_LIBUTILS_WITH_ISOC ?= y
212
213# Enables floating point support for user TAs
214# ARM32: EABI defines both a soft-float ABI and a hard-float ABI,
215#	 hard-float is basically a super set of soft-float. Hard-float
216#	 requires all the support routines provided for soft-float, but the
217#	 compiler may choose to optimize to not use some of them and use
218#	 the floating-point registers instead.
219# ARM64: EABI doesn't define a soft-float ABI, everything is hard-float (or
220#	 nothing with ` -mgeneral-regs-only`)
221# With CFG_TA_FLOAT_SUPPORT enabled TA code is free use floating point types
222CFG_TA_FLOAT_SUPPORT ?= y
223
224# Stack unwinding: print a stack dump to the console on core or TA abort, or
225# when a TA panics.
226# If CFG_UNWIND is enabled, both the kernel and user mode call stacks can be
227# unwound (not paged TAs, however).
228# Note that 32-bit ARM code needs unwind tables for this to work, so enabling
229# this option will increase the size of the 32-bit TEE binary by a few KB.
230# Similarly, TAs have to be compiled with -funwind-tables (default when the
231# option is set) otherwise they can't be unwound.
232# Warning: since the unwind sequence for user-mode (TA) code is implemented in
233# the privileged layer of OP-TEE, enabling this feature will weaken the
234# user/kernel isolation. Therefore it should be disabled in release builds.
235ifeq ($(CFG_TEE_CORE_DEBUG),y)
236CFG_UNWIND ?= y
237endif
238
239# Enable support for dynamically loaded user TAs
240CFG_WITH_USER_TA ?= y
241
242# Choosing the architecture(s) of user-mode libraries (used by TAs)
243#
244# Platforms may define a list of supported architectures for user-mode code
245# by setting $(supported-ta-targets). Valid values are "ta_arm32", "ta_arm64",
246# "ta_arm32 ta_arm64" and "ta_arm64 ta_arm32".
247# $(supported-ta-targets) defaults to "ta_arm32" when the TEE core is 32-bits,
248# and "ta_arm32 ta_arm64" when it is 64-bits (that is, when CFG_ARM64_core=y).
249# The first entry in $(supported-ta-targets) has a special role, see
250# CFG_USER_TA_TARGET_<ta-name> below.
251#
252# CFG_USER_TA_TARGETS may be defined to restrict $(supported-ta-targets) or
253# change the order of the values.
254#
255# The list of TA architectures is ultimately stored in $(ta-targets).
256
257# CFG_USER_TA_TARGET_<ta-name> (for example, CFG_USER_TA_TARGET_avb), if
258# defined, selects the unique TA architecture mode for building the in-tree TA
259# <ta-name>. Can be either ta_arm32 or ta_arm64.
260# By default, in-tree TAs are built using the first architecture specified in
261# $(ta-targets).
262
263# Address Space Layout Randomization for user-mode Trusted Applications
264#
265# When this flag is enabled, the ELF loader will introduce a random offset
266# when mapping the application in user space. ASLR makes the exploitation of
267# memory corruption vulnerabilities more difficult.
268CFG_TA_ASLR ?= y
269
270# How much ASLR may shift the base address (in pages). The base address is
271# randomly shifted by an integer number of pages comprised between these two
272# values. Bigger ranges are more secure because they make the addresses harder
273# to guess at the expense of using more memory for the page tables.
274CFG_TA_ASLR_MIN_OFFSET_PAGES ?= 0
275CFG_TA_ASLR_MAX_OFFSET_PAGES ?= 128
276
277# Address Space Layout Randomization for TEE Core
278#
279# When this flag is enabled, the early init code will introduce a random
280# offset when mapping TEE Core. ASLR makes the exploitation of memory
281# corruption vulnerabilities more difficult.
282CFG_CORE_ASLR ?= y
283
284# Load user TAs from the REE filesystem via tee-supplicant
285CFG_REE_FS_TA ?= y
286
287# Pre-authentication of TA binaries loaded from the REE filesystem
288#
289# - If CFG_REE_FS_TA_BUFFERED=y: load TA binary into a temporary buffer in the
290#   "Secure DDR" pool, check the signature, then process the file only if it is
291#   valid.
292# - If disabled: hash the binaries as they are being processed and verify the
293#   signature as a last step.
294CFG_REE_FS_TA_BUFFERED ?= n
295$(eval $(call cfg-depends-all,CFG_REE_FS_TA_BUFFERED,CFG_REE_FS_TA))
296
297# Support for loading user TAs from a special section in the TEE binary.
298# Such TAs are available even before tee-supplicant is available (hence their
299# name), but note that many services exported to TAs may need tee-supplicant,
300# so early use is limited to a subset of the TEE Internal Core API (crypto...)
301# To use this feature, set EARLY_TA_PATHS to the paths to one or more TA ELF
302# file(s). For example:
303#   $ make ... \
304#     EARLY_TA_PATHS="path/to/8aaaf200-2450-11e4-abe2-0002a5d5c51b.stripped.elf \
305#                     path/to/cb3e5ba0-adf1-11e0-998b-0002a5d5c51b.stripped.elf"
306# Typical build steps:
307#   $ make ta_dev_kit CFG_EARLY_TA=y # Create the dev kit (user mode libraries,
308#                                    # headers, makefiles), ready to build TAs.
309#                                    # CFG_EARLY_TA=y is optional, it prevents
310#                                    # later library recompilations.
311#   <build some TAs>
312#   $ make EARLY_TA_PATHS=<paths>    # Build OP-TEE and embbed the TA(s)
313#
314# Another option is CFG_IN_TREE_EARLY_TAS which is used to point at
315# in-tree TAs. CFG_IN_TREE_EARLY_TAS is formatted as:
316# <name-of-ta>/<uuid>
317# for instance avb/023f8f1a-292a-432b-8fc4-de8471358067
318ifneq ($(EARLY_TA_PATHS)$(CFG_IN_TREE_EARLY_TAS),)
319$(call force,CFG_EARLY_TA,y)
320$(call force,CFG_EMBEDDED_TS,y)
321else
322CFG_EARLY_TA ?= n
323endif
324
325ifneq ($(SP_PATHS),)
326$(call force,CFG_SECURE_PARTITION,y)
327$(call force,CFG_EMBEDDED_TS,y)
328else
329CFG_SECURE_PARTITION ?= n
330endif
331
332ifeq ($(CFG_EMBEDDED_TS),y)
333$(call force,CFG_ZLIB,y)
334endif
335
336# By default the early TAs are compressed in the TEE binary, it is possible to
337# not compress them with CFG_EARLY_TA_COMPRESS=n
338CFG_EARLY_TA_COMPRESS ?= y
339
340# Enable paging, requires SRAM, can't be enabled by default
341CFG_WITH_PAGER ?= n
342
343# Use the pager for user TAs
344CFG_PAGED_USER_TA ?= $(CFG_WITH_PAGER)
345
346# If paging of user TAs, that is, R/W paging default to enable paging of
347# TAG and IV in order to reduce heap usage.
348CFG_CORE_PAGE_TAG_AND_IV ?= $(CFG_PAGED_USER_TA)
349
350# Runtime lock dependency checker: ensures that a proper locking hierarchy is
351# used in the TEE core when acquiring and releasing mutexes. Any violation will
352# cause a panic as soon as the invalid locking condition is detected. If
353# CFG_UNWIND and CFG_LOCKDEP_RECORD_STACK are both enabled, the algorithm
354# records the call stacks when locks are taken, and prints them when a
355# potential deadlock is found.
356# Expect a significant performance impact when enabling this.
357CFG_LOCKDEP ?= n
358CFG_LOCKDEP_RECORD_STACK ?= y
359
360# BestFit algorithm in bget reduces the fragmentation of the heap when running
361# with the pager enabled or lockdep
362CFG_CORE_BGET_BESTFIT ?= $(call cfg-one-enabled, CFG_WITH_PAGER CFG_LOCKDEP)
363
364# Enable support for detected undefined behavior in C
365# Uses a lot of memory, can't be enabled by default
366CFG_CORE_SANITIZE_UNDEFINED ?= n
367
368# Enable Kernel Address sanitizer, has a huge performance impact, uses a
369# lot of memory and need platform specific adaptations, can't be enabled by
370# default
371CFG_CORE_SANITIZE_KADDRESS ?= n
372
373# Add stack guards before/after stacks and periodically check them
374CFG_WITH_STACK_CANARIES ?= y
375
376# Use compiler instrumentation to troubleshoot stack overflows.
377# When enabled, most C functions check the stack pointer against the current
378# stack limits on entry and panic immediately if it is out of range.
379CFG_CORE_DEBUG_CHECK_STACKS ?= n
380
381# Use when the default stack allocations are not sufficient.
382CFG_STACK_THREAD_EXTRA ?= 0
383CFG_STACK_TMP_EXTRA ?= 0
384
385# Device Tree support
386#
387# When CFG_DT is enabled core embeds the FDT library (libfdt) allowing
388# device tree blob (DTB) parsing from the core.
389#
390# When CFG_DT is enabled, the TEE _start function expects to find
391# the address of a DTB in register X2/R2 provided by the early boot stage
392# or value 0 if boot stage provides no DTB.
393#
394# When CFG_EMBED_DTB is enabled, CFG_EMBED_DTB_SOURCE_FILE shall define the
395# relative path of a DTS file located in core/arch/$(ARCH)/dts.
396# The DTS file is compiled into a DTB file which content is embedded in a
397# read-only section of the core.
398ifneq ($(strip $(CFG_EMBED_DTB_SOURCE_FILE)),)
399CFG_EMBED_DTB ?= y
400endif
401ifeq ($(CFG_EMBED_DTB),y)
402$(call force,CFG_DT,y)
403endif
404CFG_EMBED_DTB ?= n
405CFG_DT ?= n
406
407# Maximum size of the Device Tree Blob, has to be large enough to allow
408# editing of the supplied DTB.
409CFG_DTB_MAX_SIZE ?= 0x10000
410
411# Device Tree Overlay support.
412# This define enables support for an OP-TEE provided DTB overlay.
413# One of two modes is supported in this case:
414# 1. Append OP-TEE nodes to an existing DTB overlay located at CFG_DT_ADDR or
415#    passed in arg2
416# 2. Generate a new DTB overlay at CFG_DT_ADDR
417# A subsequent boot stage must then merge the generated overlay DTB into a main
418# DTB using the standard fdt_overlay_apply() method.
419CFG_EXTERNAL_DTB_OVERLAY ?= n
420
421# All embedded tests are supposed to be disabled by default, this flag
422# is used to control the default value of all other embedded tests
423CFG_ENABLE_EMBEDDED_TESTS ?= n
424
425# Enable core self tests and related pseudo TAs
426CFG_TEE_CORE_EMBED_INTERNAL_TESTS ?= $(CFG_ENABLE_EMBEDDED_TESTS)
427
428# Compiles bget_main_test() to be called from a test TA
429CFG_TA_BGET_TEST ?= $(CFG_ENABLE_EMBEDDED_TESTS)
430
431# This option enables OP-TEE to respond to SMP boot request: the Rich OS
432# issues this to request OP-TEE to release secondaries cores out of reset,
433# with specific core number and non-secure entry address.
434CFG_BOOT_SECONDARY_REQUEST ?= n
435
436# Default heap size for Core, 64 kB
437CFG_CORE_HEAP_SIZE ?= 65536
438
439# Default size of nexus heap. 16 kB. Used only if CFG_VIRTUALIZATION
440# is enabled
441CFG_CORE_NEX_HEAP_SIZE ?= 16384
442
443# TA profiling.
444# When this option is enabled, OP-TEE can execute Trusted Applications
445# instrumented with GCC's -pg flag and will output profiling information
446# in gmon.out format to /tmp/gmon-<ta_uuid>.out (path is defined in
447# tee-supplicant)
448# Note: this does not work well with shared libraries at the moment for a
449# couple of reasons:
450# 1. The profiling code assumes a unique executable section in the TA VA space.
451# 2. The code used to detect at run time if the TA is intrumented assumes that
452# the TA is linked statically.
453CFG_TA_GPROF_SUPPORT ?= n
454
455# TA function tracing.
456# When this option is enabled, OP-TEE can execute Trusted Applications
457# instrumented with GCC's -pg flag and will output function tracing
458# information in ftrace.out format to /tmp/ftrace-<ta_uuid>.out (path is
459# defined in tee-supplicant)
460CFG_FTRACE_SUPPORT ?= n
461
462# How to make room when the function tracing buffer is full?
463# 'shift': shift the previously stored data by the amount needed in order
464#    to always keep the latest logs (slower, especially with big buffer sizes)
465# 'wrap': discard the previous data and start at the beginning of the buffer
466#    again (fast, but can result in a mostly empty buffer)
467# 'stop': stop logging new data
468CFG_FTRACE_BUF_WHEN_FULL ?= shift
469$(call cfg-check-value,FTRACE_BUF_WHEN_FULL,shift stop wrap)
470$(call force,_CFG_FTRACE_BUF_WHEN_FULL_$(CFG_FTRACE_BUF_WHEN_FULL),y)
471
472# Function tracing: unit to be used when displaying durations
473#  0: always display durations in microseconds
474# >0: if duration is greater or equal to the specified value (in microseconds),
475#     display it in milliseconds
476CFG_FTRACE_US_MS ?= 10000
477
478# Core syscall function tracing.
479# When this option is enabled, OP-TEE core is instrumented with GCC's
480# -pg flag and will output syscall function graph in user TA ftrace
481# buffer
482CFG_SYSCALL_FTRACE ?= n
483$(call cfg-depends-all,CFG_SYSCALL_FTRACE,CFG_FTRACE_SUPPORT)
484
485# Enable to compile user TA libraries with profiling (-pg).
486# Depends on CFG_TA_GPROF_SUPPORT or CFG_FTRACE_SUPPORT.
487CFG_ULIBS_MCOUNT ?= n
488# Profiling/tracing of syscall wrapper (utee_*)
489CFG_SYSCALL_WRAPPERS_MCOUNT ?= $(CFG_ULIBS_MCOUNT)
490
491ifeq (y,$(filter y,$(CFG_ULIBS_MCOUNT) $(CFG_SYSCALL_WRAPPERS_MCOUNT)))
492ifeq (,$(filter y,$(CFG_TA_GPROF_SUPPORT) $(CFG_FTRACE_SUPPORT)))
493$(error Cannot instrument user libraries if user mode profiling is disabled)
494endif
495endif
496
497# Build libutee, libutils, libmbedtls as shared libraries.
498# - Static libraries are still generated when this is enabled, but TAs will use
499# the shared libraries unless explicitly linked with the -static flag.
500# - Shared libraries are made of two files: for example, libutee is
501#   libutee.so and 527f1a47-b92c-4a74-95bd-72f19f4a6f74.ta. The '.so' file
502#   is a totally standard shared object, and should be used to link against.
503#   The '.ta' file is a signed version of the '.so' and should be installed
504#   in the same way as TAs so that they can be found at runtime.
505CFG_ULIBS_SHARED ?= n
506
507ifeq (yy,$(CFG_TA_GPROF_SUPPORT)$(CFG_ULIBS_SHARED))
508$(error CFG_TA_GPROF_SUPPORT and CFG_ULIBS_SHARED are currently incompatible)
509endif
510
511# CFG_GP_SOCKETS
512# Enable Global Platform Sockets support
513CFG_GP_SOCKETS ?= y
514
515# Enable Secure Data Path support in OP-TEE core (TA may be invoked with
516# invocation parameters referring to specific secure memories).
517CFG_SECURE_DATA_PATH ?= n
518
519# Enable storage for TAs in secure storage, depends on CFG_REE_FS=y
520# TA binaries are stored encrypted in the REE FS and are protected by
521# metadata in secure storage.
522CFG_SECSTOR_TA ?= $(call cfg-all-enabled,CFG_REE_FS CFG_WITH_USER_TA)
523$(eval $(call cfg-depends-all,CFG_SECSTOR_TA,CFG_REE_FS CFG_WITH_USER_TA))
524
525# Enable the pseudo TA that managages TA storage in secure storage
526CFG_SECSTOR_TA_MGMT_PTA ?= $(call cfg-all-enabled,CFG_SECSTOR_TA)
527$(eval $(call cfg-depends-all,CFG_SECSTOR_TA_MGMT_PTA,CFG_SECSTOR_TA))
528
529# Enable the pseudo TA for misc. auxilary services, extending existing
530# GlobalPlatform Core API (for example, re-seeding RNG entropy pool etc.)
531CFG_SYSTEM_PTA ?= y
532
533# Enable the pseudo TA for enumeration of TEE based devices for the normal
534# world OS.
535CFG_DEVICE_ENUM_PTA ?= y
536
537# Define the number of cores per cluster used in calculating core position.
538# The cluster number is shifted by this value and added to the core ID,
539# so its value represents log2(cores/cluster).
540# Default is 2**(2) = 4 cores per cluster.
541CFG_CORE_CLUSTER_SHIFT ?= 2
542
543# Define the number of threads per core used in calculating processing
544# element's position. The core number is shifted by this value and added to
545# the thread ID, so its value represents log2(threads/core).
546# Default is 2**(0) = 1 threads per core.
547CFG_CORE_THREAD_SHIFT ?= 0
548
549# Enable support for dynamic shared memory (shared memory anywhere in
550# non-secure memory).
551CFG_CORE_DYN_SHM ?= y
552
553# Enable support for reserved shared memory (shared memory in a carved out
554# memory area).
555CFG_CORE_RESERVED_SHM ?= y
556
557# Enables support for larger physical addresses, that is, it will define
558# paddr_t as a 64-bit type.
559CFG_CORE_LARGE_PHYS_ADDR ?= n
560
561# Define the maximum size, in bits, for big numbers in the Internal Core API
562# Arithmetical functions. This does *not* influence the key size that may be
563# manipulated through the Cryptographic API.
564# Set this to a lower value to reduce the TA memory footprint.
565CFG_TA_BIGNUM_MAX_BITS ?= 2048
566
567# Define the maximum size, in bits, for big numbers in the TEE core (privileged
568# layer).
569# This value is an upper limit for the key size in any cryptographic algorithm
570# implemented by the TEE core.
571# Set this to a lower value to reduce the memory footprint.
572CFG_CORE_BIGNUM_MAX_BITS ?= 4096
573
574# Not used since libmpa was removed. Force the values to catch build scripts
575# that would set = n.
576$(call force,CFG_TA_MBEDTLS_MPI,y)
577$(call force,CFG_TA_MBEDTLS,y)
578
579# Compile the TA library mbedTLS with self test functions, the functions
580# need to be called to test anything
581CFG_TA_MBEDTLS_SELF_TEST ?= y
582
583# By default use tomcrypt as the main crypto lib providing an implementation
584# for the API in <crypto/crypto.h>
585# CFG_CRYPTOLIB_NAME is used as libname and
586# CFG_CRYPTOLIB_DIR is used as libdir when compiling the library
587#
588# It's also possible to configure to use mbedtls instead of tomcrypt.
589# Then the variables should be assigned as "CFG_CRYPTOLIB_NAME=mbedtls" and
590# "CFG_CRYPTOLIB_DIR=lib/libmbedtls" respectively.
591CFG_CRYPTOLIB_NAME ?= tomcrypt
592CFG_CRYPTOLIB_DIR ?= core/lib/libtomcrypt
593
594# Not used since libmpa was removed. Force the value to catch build scripts
595# that would set = n.
596$(call force,CFG_CORE_MBEDTLS_MPI,y)
597
598# Enable PKCS#11 TA's TEE Identity based authentication support
599CFG_PKCS11_TA_AUTH_TEE_IDENTITY ?= y
600
601# Enable PKCS#11 TA's C_DigestKey support
602CFG_PKCS11_TA_ALLOW_DIGEST_KEY ?= y
603
604# Enable virtualization support. OP-TEE will not work without compatible
605# hypervisor if this option is enabled.
606CFG_VIRTUALIZATION ?= n
607
608ifeq ($(CFG_VIRTUALIZATION),y)
609$(call force,CFG_CORE_RODATA_NOEXEC,y)
610$(call force,CFG_CORE_RWDATA_NOEXEC,y)
611
612# Default number of virtual guests
613CFG_VIRT_GUEST_COUNT ?= 2
614endif
615
616# Enables backwards compatible derivation of RPMB and SSK keys
617CFG_CORE_HUK_SUBKEY_COMPAT ?= y
618
619# Compress and encode conf.mk into the TEE core, and show the encoded string on
620# boot (with severity TRACE_INFO).
621CFG_SHOW_CONF_ON_BOOT ?= n
622
623# Enables support for passing a TPM Event Log stored in secure memory
624# to a TA, so a TPM Service could use it to extend any measurement
625# taken before the service was up and running.
626CFG_CORE_TPM_EVENT_LOG ?= n
627
628# When enabled, CFG_SCMI_MSG_DRIVERS embeds SCMI message drivers in the core.
629# Refer to the supported SCMI features embedded upon CFG_SCMI_MSG_*
630# CFG_SCMI_MSG_CLOCK embeds SCMI clock protocol support.
631# CFG_SCMI_MSG_RESET_DOMAIN embeds SCMI reset domain protocol support.
632# CFG_SCMI_MSG_SMT embeds SMT based message buffer of communication channel
633# CFG_SCMI_MSG_VOLTAGE_DOMAIN embeds SCMI voltage domain protocol support.
634CFG_SCMI_MSG_DRIVERS ?= n
635CFG_SCMI_MSG_CLOCK ?= n
636CFG_SCMI_MSG_RESET_DOMAIN ?= n
637CFG_SCMI_MSG_SMT ?= n
638CFG_SCMI_MSG_VOLTAGE_DOMAIN ?= n
639
640# Enable SCMI PTA interface for REE SCMI agents
641CFG_SCMI_PTA ?= n
642
643ifneq ($(CFG_STMM_PATH),)
644$(call force,CFG_WITH_STMM_SP,y)
645else
646CFG_WITH_STMM_SP ?= n
647endif
648ifeq ($(CFG_WITH_STMM_SP),y)
649$(call force,CFG_ZLIB,y)
650endif
651
652# When enabled checks that buffers passed to the GP Internal Core API
653# comply with the rules added as annotations as part of the definition of
654# the API. For example preventing buffers in non-secure shared memory when
655# not allowed.
656CFG_TA_STRICT_ANNOTATION_CHECKS ?= y
657
658# When enabled accepts the DES key sizes excluding parity bits as in
659# the GP Internal API Specification v1.0
660CFG_COMPAT_GP10_DES ?= y
661
662# Defines a limit for many levels TAs may call each others.
663CFG_CORE_MAX_SYSCALL_RECURSION ?= 4
664
665# Pseudo-TA to export hardware RNG output to Normal World
666# RNG characteristics are platform specific
667CFG_HWRNG_PTA ?= n
668ifeq ($(CFG_HWRNG_PTA),y)
669# Output rate of hw_get_random_bytes() in bytes per second, 0: not rate-limited
670CFG_HWRNG_RATE ?= 0
671# Quality/entropy of hw_get_random_bytes() per 1024 bits of output data, in bits
672ifeq (,$(CFG_HWRNG_QUALITY))
673$(error CFG_HWRNG_QUALITY not defined)
674endif
675endif
676