blob: 00a4e2e9bb9285a90ec043f36c25331da27016a2 [file] [log] [blame]
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +02001#
Jayanth Dodderi Chidanandce372772023-04-21 11:40:22 +01002# Copyright (c) 2018-2023, Arm Limited. All rights reserved.
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +02003#
4# SPDX-License-Identifier: BSD-3-Clause
5#
6
7# TFTF Version
8VERSION_MAJOR := 2
Juan Pablo Conde0a0f6742023-05-13 00:20:15 -05009VERSION_MINOR := 9
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +020010
Leonardo Sandoval667fd722020-09-11 12:50:19 -050011MAKE_HELPERS_DIRECTORY := make_helpers/
12include ${MAKE_HELPERS_DIRECTORY}build_macros.mk
13
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +020014################################################################################
15# Default values for build configurations, and their dependencies
16################################################################################
17
Leonardo Sandoval667fd722020-09-11 12:50:19 -050018include ${MAKE_HELPERS_DIRECTORY}defaults.mk
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +020019
20PLAT := ${DEFAULT_PLAT}
21
22# Assertions enabled for DEBUG builds by default
23ENABLE_ASSERTIONS := ${DEBUG}
24
25################################################################################
26# Checkpatch script options
27################################################################################
28
29CHECKCODE_ARGS := --no-patch
30# Do not check the coding style on imported library files or documentation files
31INC_LIB_DIRS_TO_CHECK := $(sort $(filter-out \
Mark Dykese7810b52020-06-03 15:46:55 -050032 include/lib/libfdt \
Ambroise Vincentd6e806d2019-02-11 14:34:26 +000033 include/lib/libc, \
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +020034 $(wildcard include/lib/*)))
35LIB_DIRS_TO_CHECK := $(sort $(filter-out \
36 lib/compiler-rt \
Mark Dykese7810b52020-06-03 15:46:55 -050037 lib/libfdt% \
Ambroise Vincentd6e806d2019-02-11 14:34:26 +000038 lib/libc, \
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +020039 $(wildcard lib/*)))
40ROOT_DIRS_TO_CHECK := $(sort $(filter-out \
41 lib \
42 include \
43 docs \
44 %.md \
45 %.rst, \
46 $(wildcard *)))
47CHECK_PATHS := ${ROOT_DIRS_TO_CHECK} \
48 ${INC_LIB_DIRS_TO_CHECK} \
49 ${LIB_DIRS_TO_CHECK}
50
51ifeq (${V},0)
52 Q=@
53else
54 Q=
55endif
56export Q
57
58ifneq (${DEBUG}, 0)
59 BUILD_TYPE := debug
60 # Use LOG_LEVEL_INFO by default for debug builds
61 LOG_LEVEL := 40
62else
63 BUILD_TYPE := release
64 # Use LOG_LEVEL_ERROR by default for release builds
65 LOG_LEVEL := 20
66endif
67
68# Default build string (git branch and commit)
69ifeq (${BUILD_STRING},)
Manish V Badarkhece149412022-05-24 22:54:45 +010070 BUILD_STRING := $(shell git describe --always --dirty --tags 2> /dev/null)
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +020071endif
72
73VERSION_STRING := v${VERSION_MAJOR}.${VERSION_MINOR}(${PLAT},${BUILD_TYPE}):${BUILD_STRING}
74
75BUILD_BASE := ./build
76BUILD_PLAT := ${BUILD_BASE}/${PLAT}/${BUILD_TYPE}
77
78PLAT_MAKEFILE := platform.mk
79# Generate the platforms list by recursively searching for all directories
80# under /plat containing a PLAT_MAKEFILE. Append each platform with a `|`
81# char and strip out the final '|'.
82PLATFORMS := $(shell find plat/ -name '${PLAT_MAKEFILE}' -print0 | \
83 sed -r 's%[^\x00]*\/([^/]*)\/${PLAT_MAKEFILE}\x00%\1|%g' | \
84 sed -r 's/\|$$//')
85
Sandrine Bailleuxf8228af2020-04-21 14:45:00 +020086DOCS_PATH := docs
87
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +020088ifeq (${PLAT},)
89 $(error "Error: Unknown platform. Please use PLAT=<platform name> to specify the platform")
90endif
91PLAT_PATH := $(shell find plat/ -wholename '*/${PLAT}')
92PLAT_MAKEFILE_FULL := ${PLAT_PATH}/${PLAT_MAKEFILE}
93ifeq ($(wildcard ${PLAT_MAKEFILE_FULL}),)
94 $(error "Error: Invalid platform. The following platforms are available: ${PLATFORMS}")
95endif
96
Arvind Ram Prakash2e1264d2022-05-20 12:27:40 -050097
98EL3_PAYLOAD_PLAT_PATH := $(shell find el3_payload/plat/ -wholename '*/${PLAT}')
99EL3_PAYLOAD_PLAT_MAKEFILE_FULL := ${EL3_PAYLOAD_PLAT_PATH}/${PLAT_MAKEFILE}
100
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200101.PHONY: all
102all: msg_start
103
104.PHONY: msg_start
105msg_start:
106 @echo "Building ${PLAT}"
Sandrine Bailleux043d5362018-10-03 17:05:59 +0200107 @echo "Selected set of tests: ${TESTS}"
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200108
109# Include test images makefiles.
110include tftf/framework/framework.mk
111include tftf/tests/tests.mk
112include fwu/ns_bl1u/ns_bl1u.mk
113include fwu/ns_bl2u/ns_bl2u.mk
Arunachalam Ganapathy1e51c2f2020-09-22 13:28:29 +0100114
Daniel Boulbyf6c288e2022-07-25 14:07:57 +0100115# List of secure partitions present.
116SECURE_PARTITIONS :=
117
Olivier Deprez40777f82022-11-09 10:15:28 +0100118# Only platform fvp supports cactus_mm
Arunachalam Ganapathy1e51c2f2020-09-22 13:28:29 +0100119ifeq (${ARCH}-${PLAT},aarch64-fvp)
Antonio Nino Diazf2218e72019-03-19 10:59:11 +0000120include spm/cactus_mm/cactus_mm.mk
nabkah01002e5692022-10-10 12:36:46 +0100121include realm/realm.mk
Arunachalam Ganapathy1e51c2f2020-09-22 13:28:29 +0100122endif
123
Daniel Boulbyc19215a2023-05-17 13:50:36 +0100124# cactus and ivy are supported on platforms: fvp, tc
125ifeq (${ARCH}-${PLAT},$(filter ${ARCH}-${PLAT},aarch64-fvp aarch64-tc))
Arunachalam Ganapathy1e51c2f2020-09-22 13:28:29 +0100126include spm/cactus/cactus.mk
Olivier Deprez2765ebf2020-12-16 15:46:14 +0100127include spm/ivy/ivy.mk
Arunachalam Ganapathy1e51c2f2020-09-22 13:28:29 +0100128endif
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200129
Ambroise Vincentd6e806d2019-02-11 14:34:26 +0000130################################################################################
131# Include libc
132################################################################################
133include lib/libc/libc.mk
134
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200135# Include platform specific makefile last because:
136# - the platform makefile may use all previous definitions in this file.
137# - the platform makefile may wish overwriting some of them.
138include ${PLAT_MAKEFILE_FULL}
139
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200140.SUFFIXES:
141
142################################################################################
143# Build options checks
144################################################################################
145$(eval $(call assert_boolean,DEBUG))
146$(eval $(call assert_boolean,ENABLE_ASSERTIONS))
147$(eval $(call assert_boolean,FIRMWARE_UPDATE))
148$(eval $(call assert_boolean,FWU_BL_TEST))
149$(eval $(call assert_boolean,NEW_TEST_SESSION))
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200150$(eval $(call assert_boolean,USE_NVM))
151
152################################################################################
Alexei Fedorov7fac1622020-06-19 14:25:43 +0100153# Process build options
154################################################################################
155
156# Process BRANCH_PROTECTION value and set
157# Pointer Authentication and Branch Target Identification flags
158include branch_protection.mk
159
160################################################################################
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200161# Add definitions to the cpp preprocessor based on the current build options.
162# This is done after including the platform specific makefile to allow the
163# platform to overwrite the default options
164################################################################################
165$(eval $(call add_define,TFTF_DEFINES,ARM_ARCH_MAJOR))
166$(eval $(call add_define,TFTF_DEFINES,ARM_ARCH_MINOR))
167$(eval $(call add_define,TFTF_DEFINES,DEBUG))
168$(eval $(call add_define,TFTF_DEFINES,ENABLE_ASSERTIONS))
Alexei Fedorov7fac1622020-06-19 14:25:43 +0100169$(eval $(call add_define,TFTF_DEFINES,ENABLE_BTI))
Antonio Nino Diaz9c9f92c2019-03-13 13:57:39 +0000170$(eval $(call add_define,TFTF_DEFINES,ENABLE_PAUTH))
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200171$(eval $(call add_define,TFTF_DEFINES,LOG_LEVEL))
172$(eval $(call add_define,TFTF_DEFINES,NEW_TEST_SESSION))
173$(eval $(call add_define,TFTF_DEFINES,PLAT_${PLAT}))
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200174$(eval $(call add_define,TFTF_DEFINES,USE_NVM))
175
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200176################################################################################
177
178# Assembler, compiler and linker flags shared across all test images.
179COMMON_ASFLAGS :=
180COMMON_CFLAGS :=
181COMMON_LDFLAGS :=
182
183ifeq (${DEBUG},1)
Daniel Boulbyed1f9512022-05-03 16:36:51 +0100184COMMON_CFLAGS += -g -gdwarf-4
185COMMON_ASFLAGS += -g -Wa,--gdwarf-4
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200186endif
187
Joel Hutton6a6f4832019-04-08 15:46:36 +0100188# Set the compiler's target architecture profile based on ARM_ARCH_MINOR option
189ifeq (${ARM_ARCH_MINOR},0)
Alexei Fedorovd92f4ce2020-12-07 18:13:28 +0000190march32-directive = -march=armv${ARM_ARCH_MAJOR}-a
191march64-directive = -march=armv${ARM_ARCH_MAJOR}-a
Joel Hutton6a6f4832019-04-08 15:46:36 +0100192else
Alexei Fedorovd92f4ce2020-12-07 18:13:28 +0000193march32-directive = -march=armv${ARM_ARCH_MAJOR}.${ARM_ARCH_MINOR}-a
194march64-directive = -march=armv${ARM_ARCH_MAJOR}.${ARM_ARCH_MINOR}-a
Joel Hutton6a6f4832019-04-08 15:46:36 +0100195endif
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200196
Alexei Fedorovd92f4ce2020-12-07 18:13:28 +0000197# Get architecture feature modifiers
198arch-features = ${ARM_ARCH_FEATURE}
199
200# Set the compiler's architecture feature modifiers
201ifneq ($(arch-features), none)
202ifeq ($(ARCH), aarch32)
203march32-directive := $(march32-directive)+$(arch-features)
204else
205march64-directive := $(march64-directive)+$(arch-features)
206endif
207# Print features
208$(info Arm Architecture Features specified: $(subst +, ,$(arch-features)))
209endif # arch-features
210
Joel Hutton6a6f4832019-04-08 15:46:36 +0100211COMMON_ASFLAGS_aarch64 := -mgeneral-regs-only ${march64-directive}
212COMMON_CFLAGS_aarch64 := -mgeneral-regs-only -mstrict-align ${march64-directive}
213
214COMMON_ASFLAGS_aarch32 := ${march32-directive}
215COMMON_CFLAGS_aarch32 := ${march32-directive} -mno-unaligned-access
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200216
217COMMON_ASFLAGS += -nostdinc -ffreestanding -Wa,--fatal-warnings \
218 -Werror -Wmissing-include-dirs \
Ambroise Vincentd6e806d2019-02-11 14:34:26 +0000219 -D__ASSEMBLY__ $(COMMON_ASFLAGS_$(ARCH)) \
220 ${INCLUDES}
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200221COMMON_CFLAGS += -nostdinc -ffreestanding -Wall -Werror \
222 -Wmissing-include-dirs $(COMMON_CFLAGS_$(ARCH)) \
223 -std=gnu99 -Os
224COMMON_CFLAGS += -ffunction-sections -fdata-sections
225
226# Get the content of CFLAGS user defined value last so they are appended after
227# the options defined in the Makefile
Ambroise Vincentd6e806d2019-02-11 14:34:26 +0000228COMMON_CFLAGS += ${CFLAGS} ${INCLUDES}
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200229
230COMMON_LDFLAGS += --fatal-warnings -O1 --gc-sections --build-id=none
231
232CC := ${CROSS_COMPILE}gcc
233CPP := ${CROSS_COMPILE}cpp
234AS := ${CROSS_COMPILE}gcc
235AR := ${CROSS_COMPILE}ar
236LD := ${CROSS_COMPILE}ld
237OC := ${CROSS_COMPILE}objcopy
238OD := ${CROSS_COMPILE}objdump
239NM := ${CROSS_COMPILE}nm
240PP := ${CROSS_COMPILE}gcc
241
Soby Mathew25d9e2f2023-05-05 10:51:57 +0100242# With ld.bfd version 2.39 and newer new warnings are added. Skip those since we
243# are not loaded by a elf loader.
244COMMON_LDFLAGS += $(call ld_option, --no-warn-rwx-segments)
245
Govindraj Raja1421d772023-05-05 09:15:43 -0500246# https://gcc.gnu.org/bugzilla/show_bug.cgi?id=105523
247COMMON_CFLAGS += $(call cc_option, --param=min-pagesize=0)
248
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200249################################################################################
250
Mark Dykese7810b52020-06-03 15:46:55 -0500251TFTF_SOURCES := ${FRAMEWORK_SOURCES} ${TESTS_SOURCES} ${PLAT_SOURCES} ${LIBC_SRCS} ${LIBFDT_SRCS}
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200252TFTF_INCLUDES += ${PLAT_INCLUDES}
253TFTF_CFLAGS += ${COMMON_CFLAGS}
254TFTF_ASFLAGS += ${COMMON_ASFLAGS}
255TFTF_LDFLAGS += ${COMMON_LDFLAGS}
Mark Dykese7810b52020-06-03 15:46:55 -0500256TFTF_EXTRA_OBJS :=
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200257
Alexei Fedorov7fac1622020-06-19 14:25:43 +0100258ifneq (${BP_OPTION},none)
259TFTF_CFLAGS += -mbranch-protection=${BP_OPTION}
260NS_BL1U_CFLAGS += -mbranch-protection=${BP_OPTION}
261NS_BL2U_CFLAGS += -mbranch-protection=${BP_OPTION}
262CACTUS_MM_CFLAGS += -mbranch-protection=${BP_OPTION}
263CACTUS_CFLAGS += -mbranch-protection=${BP_OPTION}
264IVY_CFLAGS += -mbranch-protection=${BP_OPTION}
AlexeiFedorov193b3562022-12-22 16:50:08 +0000265REALM_CFLAGS += -mbranch-protection=${BP_OPTION}
Antonio Nino Diaz9c9f92c2019-03-13 13:57:39 +0000266endif
267
Mark Dykese7810b52020-06-03 15:46:55 -0500268ifeq ($(SMC_FUZZING), 1)
269TFTF_EXTRA_OBJS += ${BUILD_PLAT}/smcf/dtb.o
270endif
271
Olivier Deprez231115d2020-02-03 11:27:01 +0100272#####################################################################################
273ifneq ($(findstring gcc,$(notdir $(LD))),)
274 PIE_LDFLAGS += -Wl,-pie -Wl,--no-dynamic-linker
275else
276 PIE_LDFLAGS += -pie --no-dynamic-linker
277endif
278
279#####################################################################################
Ambroise Vincentd6e806d2019-02-11 14:34:26 +0000280NS_BL1U_SOURCES += ${PLAT_SOURCES} ${LIBC_SRCS}
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200281NS_BL1U_INCLUDES += ${PLAT_INCLUDES}
282NS_BL1U_CFLAGS += ${COMMON_CFLAGS}
283NS_BL1U_ASFLAGS += ${COMMON_ASFLAGS}
284NS_BL1U_LDFLAGS += ${COMMON_LDFLAGS}
285
Ambroise Vincentd6e806d2019-02-11 14:34:26 +0000286NS_BL2U_SOURCES += ${PLAT_SOURCES} ${LIBC_SRCS}
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200287NS_BL2U_INCLUDES += ${PLAT_INCLUDES}
288NS_BL2U_CFLAGS += ${COMMON_CFLAGS}
289NS_BL2U_ASFLAGS += ${COMMON_ASFLAGS}
290NS_BL2U_LDFLAGS += ${COMMON_LDFLAGS}
291
Antonio Nino Diazf2218e72019-03-19 10:59:11 +0000292CACTUS_MM_SOURCES += ${LIBC_SRCS}
293CACTUS_MM_INCLUDES += ${PLAT_INCLUDES}
294CACTUS_MM_CFLAGS += ${COMMON_CFLAGS}
295CACTUS_MM_ASFLAGS += ${COMMON_ASFLAGS}
296CACTUS_MM_LDFLAGS += ${COMMON_LDFLAGS}
297
Ambroise Vincentd6e806d2019-02-11 14:34:26 +0000298CACTUS_SOURCES += ${LIBC_SRCS}
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200299CACTUS_INCLUDES += ${PLAT_INCLUDES}
Olivier Deprez231115d2020-02-03 11:27:01 +0100300CACTUS_CFLAGS += ${COMMON_CFLAGS} -fpie
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200301CACTUS_ASFLAGS += ${COMMON_ASFLAGS}
Olivier Deprez231115d2020-02-03 11:27:01 +0100302CACTUS_LDFLAGS += ${COMMON_LDFLAGS} $(PIE_LDFLAGS)
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200303
Ambroise Vincentd6e806d2019-02-11 14:34:26 +0000304IVY_SOURCES += ${LIBC_SRCS}
Antonio Nino Diaz0b1ab402018-12-05 15:38:39 +0000305IVY_INCLUDES += ${PLAT_INCLUDES}
Ruari Phipps9f1952c2020-08-24 11:32:32 +0100306IVY_CFLAGS += ${COMMON_CFLAGS} -fpie
Antonio Nino Diaz0b1ab402018-12-05 15:38:39 +0000307IVY_ASFLAGS += ${COMMON_ASFLAGS}
Ruari Phipps9f1952c2020-08-24 11:32:32 +0100308IVY_LDFLAGS += ${COMMON_LDFLAGS} $(PIE_LDFLAGS)
Antonio Nino Diaz0b1ab402018-12-05 15:38:39 +0000309
nabkah01002e5692022-10-10 12:36:46 +0100310REALM_SOURCES += ${LIBC_SRCS}
311REALM_CFLAGS += ${COMMON_CFLAGS} -fpie
312REALM_ASFLAGS += ${COMMON_ASFLAGS}
313REALM_LDFLAGS += ${COMMON_LDFLAGS} $(PIE_LDFLAGS)
314
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200315.PHONY: locate-checkpatch
316locate-checkpatch:
317ifndef CHECKPATCH
318 $(error "Please set CHECKPATCH to point to the Linux checkpatch.pl file, eg: CHECKPATCH=../linux/script/checkpatch.pl")
319else
320ifeq (,$(wildcard ${CHECKPATCH}))
321 $(error "The file CHECKPATCH points to cannot be found, use eg: CHECKPATCH=../linux/script/checkpatch.pl")
322endif
323endif
324
325.PHONY: clean
326clean:
327 @echo " CLEAN"
328 ${Q}rm -rf ${BUILD_PLAT}
Shriram K86879852022-09-15 15:45:05 +0530329ifneq ($(wildcard ${EL3_PAYLOAD_PLAT_MAKEFILE_FULL}),)
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200330 ${MAKE} -C el3_payload clean
Shriram K86879852022-09-15 15:45:05 +0530331endif
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200332
333.PHONY: realclean distclean
334realclean distclean:
335 @echo " REALCLEAN"
336 ${Q}rm -rf ${BUILD_BASE}
337 ${Q}rm -f ${CURDIR}/cscope.*
Shriram K86879852022-09-15 15:45:05 +0530338ifneq ($(wildcard ${EL3_PAYLOAD_PLAT_MAKEFILE_FULL}),)
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200339 ${MAKE} -C el3_payload distclean
Shriram K86879852022-09-15 15:45:05 +0530340endif
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200341
342.PHONY: checkcodebase
343checkcodebase: locate-checkpatch
344 @echo " CHECKING STYLE"
345 @if test -d .git ; then \
Mark Dykese7810b52020-06-03 15:46:55 -0500346 git ls-files | grep -E -v 'libfdt|libc|docs|\.md|\.rst' | \
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200347 while read GIT_FILE ; \
348 do ${CHECKPATCH} ${CHECKCODE_ARGS} -f $$GIT_FILE ; \
349 done ; \
350 else \
351 find . -type f -not -iwholename "*.git*" \
352 -not -iwholename "*build*" \
Mark Dykese7810b52020-06-03 15:46:55 -0500353 -not -iwholename "*libfdt*" \
Ambroise Vincentd6e806d2019-02-11 14:34:26 +0000354 -not -iwholename "*libc*" \
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200355 -not -iwholename "*docs*" \
356 -not -iwholename "*.md" \
357 -not -iwholename "*.rst" \
358 -exec ${CHECKPATCH} ${CHECKCODE_ARGS} -f {} \; ; \
359 fi
360
361.PHONY: checkpatch
362checkpatch: locate-checkpatch
363 @echo " CHECKING STYLE"
364 ${Q}COMMON_COMMIT=$$(git merge-base HEAD ${BASE_COMMIT}); \
365 for commit in `git rev-list $$COMMON_COMMIT..HEAD`; do \
366 printf "\n[*] Checking style of '$$commit'\n\n"; \
367 git log --format=email "$$commit~..$$commit" \
368 -- ${CHECK_PATHS} | ${CHECKPATCH} - || true; \
369 git diff --format=email "$$commit~..$$commit" \
370 -- ${CHECK_PATHS} | ${CHECKPATCH} - || true; \
371 done
372
373ifneq (${FIRMWARE_UPDATE},1)
374.PHONY: ns_bl1u ns_bl2u
375ns_bl1u ns_bl2u:
376 @echo "ERROR: Can't build $@ because Firmware Update is not supported \
377 on this platform."
378 @exit 1
379endif
380
381ifneq (${ARCH}-${PLAT},aarch64-fvp)
Antonio Nino Diazf2218e72019-03-19 10:59:11 +0000382.PHONY: cactus_mm
383cactus_mm:
384 @echo "ERROR: $@ is supported only on AArch64 FVP."
385 @exit 1
386
nabkah01002e5692022-10-10 12:36:46 +0100387.PHONY: realm
388realm:
389 @echo "ERROR: $@ is supported only on AArch64 FVP."
390 @exit 1
391
392.PHONY: pack_realm
393pack_realm:
394 @echo "Nothing to be done"
395 @exit 1
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200396endif
397
Daniel Boulbyc19215a2023-05-17 13:50:36 +0100398ifneq (${ARCH}-${PLAT},$(filter ${ARCH}-${PLAT},aarch64-fvp aarch64-tc))
Arunachalam Ganapathy1e51c2f2020-09-22 13:28:29 +0100399.PHONY: cactus
400cactus:
Daniel Boulbyc19215a2023-05-17 13:50:36 +0100401 @echo "ERROR: $@ is supported only on AArch64 FVP or TC."
Arunachalam Ganapathy1e51c2f2020-09-22 13:28:29 +0100402 @exit 1
Olivier Deprez2765ebf2020-12-16 15:46:14 +0100403
404.PHONY: ivy
405ivy:
Daniel Boulbyc19215a2023-05-17 13:50:36 +0100406 @echo "ERROR: $@ is supported only on AArch64 FVP or TC."
Olivier Deprez2765ebf2020-12-16 15:46:14 +0100407 @exit 1
Arunachalam Ganapathy1e51c2f2020-09-22 13:28:29 +0100408endif
409
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200410MAKE_DEP = -Wp,-MD,$(DEP) -MT $$@
411
412define MAKE_C
413
414$(eval OBJ := $(1)/$(patsubst %.c,%.o,$(notdir $(2))))
415$(eval DEP := $(patsubst %.o,%.d,$(OBJ)))
416
Bence Szépkúti537b3582019-11-29 18:23:56 +0100417$(OBJ) : $(2) | $(AUTOGEN_DIR)/tests_list.h
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200418 @echo " CC $$<"
419 $$(Q)$$(CC) $$($(3)_CFLAGS) ${$(3)_INCLUDES} ${$(3)_DEFINES} -DIMAGE_$(3) $(MAKE_DEP) -c $$< -o $$@
420
421-include $(DEP)
422endef
423
424
425define MAKE_S
426
427$(eval OBJ := $(1)/$(patsubst %.S,%.o,$(notdir $(2))))
428$(eval DEP := $(patsubst %.o,%.d,$(OBJ)))
429
Bence Szépkúti537b3582019-11-29 18:23:56 +0100430$(OBJ) : $(2) | $(AUTOGEN_DIR)/tests_list.h
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200431 @echo " AS $$<"
432 $$(Q)$$(AS) $$($(3)_ASFLAGS) ${$(3)_INCLUDES} ${$(3)_DEFINES} -DIMAGE_$(3) $(MAKE_DEP) -c $$< -o $$@
433
434-include $(DEP)
435endef
436
437
438define MAKE_LD
439
440$(eval DEP := $(1).d)
441
Bence Szépkúti537b3582019-11-29 18:23:56 +0100442$(1) : $(2) | $(AUTOGEN_DIR)/tests_list.h
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200443 @echo " PP $$<"
444 $$(Q)$$(AS) $$($(3)_ASFLAGS) ${$(3)_INCLUDES} ${$(3)_DEFINES} -P -E $(MAKE_DEP) -o $$@ $$<
445
446-include $(DEP)
447endef
448
449
450define MAKE_OBJS
451 $(eval C_OBJS := $(filter %.c,$(2)))
452 $(eval REMAIN := $(filter-out %.c,$(2)))
453 $(eval $(foreach obj,$(C_OBJS),$(call MAKE_C,$(1),$(obj),$(3))))
454
455 $(eval S_OBJS := $(filter %.S,$(REMAIN)))
456 $(eval REMAIN := $(filter-out %.S,$(REMAIN)))
457 $(eval $(foreach obj,$(S_OBJS),$(call MAKE_S,$(1),$(obj),$(3))))
458
459 $(and $(REMAIN),$(error Unexpected source files present: $(REMAIN)))
460endef
461
462
463# NOTE: The line continuation '\' is required in the next define otherwise we
464# end up with a line-feed characer at the end of the last c filename.
465# Also bare this issue in mind if extending the list of supported filetypes.
466define SOURCES_TO_OBJS
467 $(notdir $(patsubst %.c,%.o,$(filter %.c,$(1)))) \
468 $(notdir $(patsubst %.S,%.o,$(filter %.S,$(1))))
469endef
470
471define uppercase
472$(shell echo $(1) | tr '[:lower:]' '[:upper:]')
473endef
474
475define MAKE_IMG
476 $(eval IMG_PREFIX := $(call uppercase, $(1)))
477 $(eval BUILD_DIR := ${BUILD_PLAT}/$(1))
478 $(eval SOURCES := $(${IMG_PREFIX}_SOURCES))
479 $(eval OBJS := $(addprefix $(BUILD_DIR)/,$(call SOURCES_TO_OBJS,$(SOURCES))))
Mark Dykese7810b52020-06-03 15:46:55 -0500480 $(eval OBJS += $(${IMG_PREFIX}_EXTRA_OBJS))
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200481 $(eval LINKERFILE := $(BUILD_DIR)/$(1).ld)
482 $(eval MAPFILE := $(BUILD_DIR)/$(1).map)
483 $(eval ELF := $(BUILD_DIR)/$(1).elf)
484 $(eval DUMP := $(BUILD_DIR)/$(1).dump)
485 $(eval BIN := $(BUILD_PLAT)/$(1).bin)
486
487 $(eval $(call MAKE_OBJS,$(BUILD_DIR),$(SOURCES),${IMG_PREFIX}))
488 $(eval $(call MAKE_LD,$(LINKERFILE),$(${IMG_PREFIX}_LINKERFILE),${IMG_PREFIX}))
489
490$(BUILD_DIR) :
491 $$(Q)mkdir -p "$$@"
492
493$(ELF) : $(OBJS) $(LINKERFILE)
494 @echo " LD $$@"
495 @echo 'const char build_message[] = "Built : "__TIME__", "__DATE__; \
496 const char version_string[] = "${VERSION_STRING}";' | \
497 $$(CC) $$(${IMG_PREFIX}_CFLAGS) ${${IMG_PREFIX}_INCLUDES} ${${IMG_PREFIX}_DEFINES} -c -xc - -o $(BUILD_DIR)/build_message.o
498 $$(Q)$$(LD) -o $$@ $$(${IMG_PREFIX}_LDFLAGS) -Map=$(MAPFILE) \
499 -T $(LINKERFILE) $(BUILD_DIR)/build_message.o $(OBJS)
500
501$(DUMP) : $(ELF)
502 @echo " OD $$@"
503 $${Q}$${OD} -dx $$< > $$@
504
505$(BIN) : $(ELF)
506 @echo " BIN $$@"
507 $$(Q)$$(OC) -O binary $$< $$@
508 @echo
509 @echo "Built $$@ successfully"
510 @echo
511
512.PHONY : $(1)
513$(1) : $(BUILD_DIR) $(BIN) $(DUMP)
514
515all : $(1)
516
517endef
518
Shruti Gupta2eb601b2023-03-29 21:35:17 +0100519ifeq (${ARCH},aarch32)
520 ARCH_TESTS_SKIP_LIST := tftf/tests/aarch32_tests_to_skip.txt
521endif
522
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200523$(AUTOGEN_DIR):
524 $(Q)mkdir -p "$@"
525
Shruti Gupta2eb601b2023-03-29 21:35:17 +0100526$(AUTOGEN_DIR)/tests_list.c $(AUTOGEN_DIR)/tests_list.h: $(AUTOGEN_DIR) ${TESTS_FILE} ${PLAT_TESTS_SKIP_LIST} $(ARCH_TESTS_SKIP_LIST)
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200527 @echo " AUTOGEN $@"
Shruti Gupta2eb601b2023-03-29 21:35:17 +0100528 tools/generate_test_list/generate_test_list.pl $(AUTOGEN_DIR)/tests_list.c \
529 $(AUTOGEN_DIR)/tests_list.h ${TESTS_FILE} $(PLAT_TESTS_SKIP_LIST) $(ARCH_TESTS_SKIP_LIST)
Mark Dykese7810b52020-06-03 15:46:55 -0500530ifeq ($(SMC_FUZZING), 1)
531 $(Q)mkdir -p ${BUILD_PLAT}/smcf
532 dtc ${SMC_FUZZ_DTS} >> ${BUILD_PLAT}/smcf/dtb
533 $(OC) -I binary -O elf64-littleaarch64 -B aarch64 ${BUILD_PLAT}/smcf/dtb ${BUILD_PLAT}/smcf/dtb.o \
johpow01d5c79cc2021-06-23 16:10:22 -0500534 --redefine-sym _binary___build_$(PLAT)_$(BUILD_TYPE)_smcf_dtb_start=_binary___dtb_start \
535 --redefine-sym _binary___build_$(PLAT)_$(BUILD_TYPE)_smcf_dtb_end=_binary___dtb_end
Mark Dykese7810b52020-06-03 15:46:55 -0500536endif
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200537
538$(eval $(call MAKE_IMG,tftf))
539
540ifeq ($(FIRMWARE_UPDATE), 1)
541 $(eval $(call MAKE_IMG,ns_bl1u))
542 $(eval $(call MAKE_IMG,ns_bl2u))
543endif
544
545ifeq (${ARCH}-${PLAT},aarch64-fvp)
Antonio Nino Diazf2218e72019-03-19 10:59:11 +0000546 $(eval $(call MAKE_IMG,cactus_mm))
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200547 $(eval $(call MAKE_IMG,cactus))
Antonio Nino Diaz0b1ab402018-12-05 15:38:39 +0000548 $(eval $(call MAKE_IMG,ivy))
nabkah01002e5692022-10-10 12:36:46 +0100549 $(eval $(call MAKE_IMG,realm))
550endif
551
552ifeq (${ARCH}-${PLAT},aarch64-fvp)
553.PHONY : pack_realm
554pack_realm: realm tftf
555 @echo " PACK REALM PAYLOAD"
556 $(shell dd if=$(BUILD_PLAT)/realm.bin of=$(BUILD_PLAT)/tftf.bin obs=1 \
557 seek=$(TFTF_MAX_IMAGE_SIZE))
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200558endif
559
Daniel Boulbyc19215a2023-05-17 13:50:36 +0100560ifeq (${ARCH}-${PLAT},aarch64-tc)
Arunachalam Ganapathy1e51c2f2020-09-22 13:28:29 +0100561 $(eval $(call MAKE_IMG,cactus))
Olivier Deprez2765ebf2020-12-16 15:46:14 +0100562 $(eval $(call MAKE_IMG,ivy))
Arunachalam Ganapathy1e51c2f2020-09-22 13:28:29 +0100563endif
564
Daniel Boulbyf6c288e2022-07-25 14:07:57 +0100565SP_LAYOUT:
566 ${Q}tools/generate_json/generate_json.sh \
567 $(BUILD_PLAT) $(SECURE_PARTITIONS)
568
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200569# The EL3 test payload is only supported in AArch64. It has an independent build
570# system.
571.PHONY: el3_payload
572ifneq (${ARCH},aarch32)
Arvind Ram Prakash2e1264d2022-05-20 12:27:40 -0500573ifneq ($(wildcard ${EL3_PAYLOAD_PLAT_MAKEFILE_FULL}),)
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200574el3_payload: $(BUILD_DIR)
575 ${Q}${MAKE} -C el3_payload PLAT=${PLAT}
576 ${Q}find "el3_payload/build/${PLAT}" -name '*.bin' -exec cp {} "${BUILD_PLAT}" \;
577
578all: el3_payload
579endif
Arvind Ram Prakash2e1264d2022-05-20 12:27:40 -0500580endif
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200581
Sandrine Bailleuxf8228af2020-04-21 14:45:00 +0200582doc:
583 @echo " BUILD DOCUMENTATION"
584 ${Q}${MAKE} --no-print-directory -C ${DOCS_PATH} html
585
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200586.PHONY: cscope
587cscope:
588 @echo " CSCOPE"
589 ${Q}find ${CURDIR} -name "*.[chsS]" > cscope.files
590 ${Q}cscope -b -q -k
591
592.PHONY: help
Leonardo Sandoval770b4312020-09-11 14:44:40 -0500593.SILENT: help
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200594help:
Leonardo Sandoval770b4312020-09-11 14:44:40 -0500595 echo "usage: ${MAKE} PLAT=<${PLATFORMS}> \
Olivier Deprez40777f82022-11-09 10:15:28 +0100596<all|tftf|ns_bl1u|ns_bl2u|cactus|ivy|realm|pack_realm|el3_payload|distclean|clean|checkcodebase|checkpatch|help_tests>"
Leonardo Sandoval770b4312020-09-11 14:44:40 -0500597 echo ""
598 echo "PLAT is used to specify which platform you wish to build."
599 echo "If no platform is specified, PLAT defaults to: ${DEFAULT_PLAT}"
600 echo ""
601 echo "Supported Targets:"
602 echo " all Build all supported binaries for this platform"
603 echo " (i.e. TFTF and FWU images)"
604 echo " tftf Build the TFTF image"
605 echo " ns_bl1u Build the NS_BL1U image"
606 echo " ns_bl2u Build the NS_BL2U image"
nabkah01002e5692022-10-10 12:36:46 +0100607 echo " realm Build the Realm image (Test R-EL1 payload)."
608 echo " pack_realm Pack the realm image to tftf.bin."
Olivier Deprez40777f82022-11-09 10:15:28 +0100609 echo " cactus Build the Cactus image (FF-A S-EL1 test payload)."
610 echo " cactus_mm Build the Cactus-MM image (SPM-MM S-EL0 test payload)."
611 echo " ivy Build the Ivy image (FF-A S-EL0 test payload)."
Leonardo Sandoval770b4312020-09-11 14:44:40 -0500612 echo " el3_payload Build the EL3 test payload"
613 echo " checkcodebase Check the coding style of the entire source tree"
614 echo " checkpatch Check the coding style on changes in the current"
615 echo " branch against BASE_COMMIT (default origin/master)"
616 echo " doc Build html based documentation using Sphinx tool"
617 echo " clean Clean the build for the selected platform"
618 echo " cscope Generate cscope index"
619 echo " distclean Remove all build artifacts for all platforms"
620 echo " help_tests List all possible sets of tests"
621 echo ""
622 echo "note: most build targets require PLAT to be set to a specific platform."
623 echo ""
624 echo "example: build all targets for the FVP platform:"
625 echo " CROSS_COMPILE=aarch64-none-elf- make PLAT=fvp all"