blob: e1048141ac48ddfdbc39fb6452a05b7e74e30ec1 [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
Jayanth Dodderi Chidanandd2a63642023-06-06 09:03:53 +010058################################################################################
59# Toolchain configs
60################################################################################
61CC := ${CROSS_COMPILE}gcc
62CPP := ${CROSS_COMPILE}cpp
63AS := ${CROSS_COMPILE}gcc
64AR := ${CROSS_COMPILE}ar
65LD := ${CROSS_COMPILE}ld
66OC := ${CROSS_COMPILE}objcopy
67OD := ${CROSS_COMPILE}objdump
68NM := ${CROSS_COMPILE}nm
69PP := ${CROSS_COMPILE}gcc
70
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +020071ifneq (${DEBUG}, 0)
72 BUILD_TYPE := debug
73 # Use LOG_LEVEL_INFO by default for debug builds
74 LOG_LEVEL := 40
75else
76 BUILD_TYPE := release
77 # Use LOG_LEVEL_ERROR by default for release builds
78 LOG_LEVEL := 20
79endif
80
81# Default build string (git branch and commit)
82ifeq (${BUILD_STRING},)
Manish V Badarkhece149412022-05-24 22:54:45 +010083 BUILD_STRING := $(shell git describe --always --dirty --tags 2> /dev/null)
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +020084endif
85
86VERSION_STRING := v${VERSION_MAJOR}.${VERSION_MINOR}(${PLAT},${BUILD_TYPE}):${BUILD_STRING}
87
88BUILD_BASE := ./build
89BUILD_PLAT := ${BUILD_BASE}/${PLAT}/${BUILD_TYPE}
90
91PLAT_MAKEFILE := platform.mk
92# Generate the platforms list by recursively searching for all directories
93# under /plat containing a PLAT_MAKEFILE. Append each platform with a `|`
94# char and strip out the final '|'.
95PLATFORMS := $(shell find plat/ -name '${PLAT_MAKEFILE}' -print0 | \
96 sed -r 's%[^\x00]*\/([^/]*)\/${PLAT_MAKEFILE}\x00%\1|%g' | \
97 sed -r 's/\|$$//')
98
Sandrine Bailleuxf8228af2020-04-21 14:45:00 +020099DOCS_PATH := docs
100
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200101ifeq (${PLAT},)
102 $(error "Error: Unknown platform. Please use PLAT=<platform name> to specify the platform")
103endif
104PLAT_PATH := $(shell find plat/ -wholename '*/${PLAT}')
105PLAT_MAKEFILE_FULL := ${PLAT_PATH}/${PLAT_MAKEFILE}
106ifeq ($(wildcard ${PLAT_MAKEFILE_FULL}),)
107 $(error "Error: Invalid platform. The following platforms are available: ${PLATFORMS}")
108endif
109
Arvind Ram Prakash2e1264d2022-05-20 12:27:40 -0500110
111EL3_PAYLOAD_PLAT_PATH := $(shell find el3_payload/plat/ -wholename '*/${PLAT}')
112EL3_PAYLOAD_PLAT_MAKEFILE_FULL := ${EL3_PAYLOAD_PLAT_PATH}/${PLAT_MAKEFILE}
113
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200114.PHONY: all
115all: msg_start
116
117.PHONY: msg_start
118msg_start:
119 @echo "Building ${PLAT}"
Sandrine Bailleux043d5362018-10-03 17:05:59 +0200120 @echo "Selected set of tests: ${TESTS}"
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200121
Shruti Guptac973b2a2023-07-12 12:10:54 +0100122# Set flags for Realm Payload Tests
123ifeq (${ENABLE_REALM_PAYLOAD_TESTS},1)
Shruti Gupta24597d12023-10-02 10:40:19 +0100124ARM_ARCH_MINOR := 5
Shruti Guptac973b2a2023-07-12 12:10:54 +0100125BRANCH_PROTECTION := 2
126endif
127
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200128# Include test images makefiles.
129include tftf/framework/framework.mk
130include tftf/tests/tests.mk
131include fwu/ns_bl1u/ns_bl1u.mk
132include fwu/ns_bl2u/ns_bl2u.mk
Arunachalam Ganapathy1e51c2f2020-09-22 13:28:29 +0100133
Daniel Boulbyf6c288e2022-07-25 14:07:57 +0100134# List of secure partitions present.
135SECURE_PARTITIONS :=
136
Olivier Deprez40777f82022-11-09 10:15:28 +0100137# Only platform fvp supports cactus_mm
Arunachalam Ganapathy1e51c2f2020-09-22 13:28:29 +0100138ifeq (${ARCH}-${PLAT},aarch64-fvp)
Antonio Nino Diazf2218e72019-03-19 10:59:11 +0000139include spm/cactus_mm/cactus_mm.mk
nabkah01002e5692022-10-10 12:36:46 +0100140include realm/realm.mk
Arunachalam Ganapathy1e51c2f2020-09-22 13:28:29 +0100141endif
142
Daniel Boulbyc19215a2023-05-17 13:50:36 +0100143# cactus and ivy are supported on platforms: fvp, tc
144ifeq (${ARCH}-${PLAT},$(filter ${ARCH}-${PLAT},aarch64-fvp aarch64-tc))
Arunachalam Ganapathy1e51c2f2020-09-22 13:28:29 +0100145include spm/cactus/cactus.mk
Olivier Deprez2765ebf2020-12-16 15:46:14 +0100146include spm/ivy/ivy.mk
Arunachalam Ganapathy1e51c2f2020-09-22 13:28:29 +0100147endif
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200148
Ambroise Vincentd6e806d2019-02-11 14:34:26 +0000149################################################################################
150# Include libc
151################################################################################
152include lib/libc/libc.mk
153
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200154# Include platform specific makefile last because:
155# - the platform makefile may use all previous definitions in this file.
156# - the platform makefile may wish overwriting some of them.
157include ${PLAT_MAKEFILE_FULL}
158
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200159.SUFFIXES:
160
161################################################################################
162# Build options checks
163################################################################################
164$(eval $(call assert_boolean,DEBUG))
165$(eval $(call assert_boolean,ENABLE_ASSERTIONS))
166$(eval $(call assert_boolean,FIRMWARE_UPDATE))
167$(eval $(call assert_boolean,FWU_BL_TEST))
168$(eval $(call assert_boolean,NEW_TEST_SESSION))
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200169$(eval $(call assert_boolean,USE_NVM))
Shruti Guptac973b2a2023-07-12 12:10:54 +0100170$(eval $(call assert_numeric,BRANCH_PROTECTION))
171$(eval $(call assert_boolean,ENABLE_REALM_PAYLOAD_TESTS))
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200172
173################################################################################
Alexei Fedorov7fac1622020-06-19 14:25:43 +0100174# Process build options
175################################################################################
176
177# Process BRANCH_PROTECTION value and set
178# Pointer Authentication and Branch Target Identification flags
179include branch_protection.mk
180
181################################################################################
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200182# Add definitions to the cpp preprocessor based on the current build options.
183# This is done after including the platform specific makefile to allow the
184# platform to overwrite the default options
185################################################################################
186$(eval $(call add_define,TFTF_DEFINES,ARM_ARCH_MAJOR))
187$(eval $(call add_define,TFTF_DEFINES,ARM_ARCH_MINOR))
188$(eval $(call add_define,TFTF_DEFINES,DEBUG))
189$(eval $(call add_define,TFTF_DEFINES,ENABLE_ASSERTIONS))
Alexei Fedorov7fac1622020-06-19 14:25:43 +0100190$(eval $(call add_define,TFTF_DEFINES,ENABLE_BTI))
Antonio Nino Diaz9c9f92c2019-03-13 13:57:39 +0000191$(eval $(call add_define,TFTF_DEFINES,ENABLE_PAUTH))
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200192$(eval $(call add_define,TFTF_DEFINES,LOG_LEVEL))
193$(eval $(call add_define,TFTF_DEFINES,NEW_TEST_SESSION))
194$(eval $(call add_define,TFTF_DEFINES,PLAT_${PLAT}))
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200195$(eval $(call add_define,TFTF_DEFINES,USE_NVM))
Soby Mathew6e5c9962023-10-06 16:38:13 +0100196$(eval $(call add_define,TFTF_DEFINES,ENABLE_REALM_PAYLOAD_TESTS))
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200197
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200198################################################################################
199
Jayanth Dodderi Chidanandd2a63642023-06-06 09:03:53 +0100200################################################################################
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200201# Assembler, compiler and linker flags shared across all test images.
Jayanth Dodderi Chidanandd2a63642023-06-06 09:03:53 +0100202################################################################################
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200203COMMON_ASFLAGS :=
204COMMON_CFLAGS :=
205COMMON_LDFLAGS :=
206
207ifeq (${DEBUG},1)
Daniel Boulbyed1f9512022-05-03 16:36:51 +0100208COMMON_CFLAGS += -g -gdwarf-4
209COMMON_ASFLAGS += -g -Wa,--gdwarf-4
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200210endif
211
Joel Hutton6a6f4832019-04-08 15:46:36 +0100212# Set the compiler's target architecture profile based on ARM_ARCH_MINOR option
213ifeq (${ARM_ARCH_MINOR},0)
Alexei Fedorovd92f4ce2020-12-07 18:13:28 +0000214march32-directive = -march=armv${ARM_ARCH_MAJOR}-a
215march64-directive = -march=armv${ARM_ARCH_MAJOR}-a
Joel Hutton6a6f4832019-04-08 15:46:36 +0100216else
Alexei Fedorovd92f4ce2020-12-07 18:13:28 +0000217march32-directive = -march=armv${ARM_ARCH_MAJOR}.${ARM_ARCH_MINOR}-a
218march64-directive = -march=armv${ARM_ARCH_MAJOR}.${ARM_ARCH_MINOR}-a
Joel Hutton6a6f4832019-04-08 15:46:36 +0100219endif
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200220
Alexei Fedorovd92f4ce2020-12-07 18:13:28 +0000221# Get architecture feature modifiers
222arch-features = ${ARM_ARCH_FEATURE}
223
224# Set the compiler's architecture feature modifiers
225ifneq ($(arch-features), none)
226ifeq ($(ARCH), aarch32)
227march32-directive := $(march32-directive)+$(arch-features)
228else
229march64-directive := $(march64-directive)+$(arch-features)
230endif
231# Print features
232$(info Arm Architecture Features specified: $(subst +, ,$(arch-features)))
233endif # arch-features
234
Jayanth Dodderi Chidanandd2a63642023-06-06 09:03:53 +0100235################################################################################
236# Compiler settings
237################################################################################
238ifneq ($(findstring clang,$(notdir $(CC))),)
239CLANG_CFLAGS_aarch64 := -target aarch64-elf
Joel Hutton6a6f4832019-04-08 15:46:36 +0100240
Jayanth Dodderi Chidanandd2a63642023-06-06 09:03:53 +0100241CPP := $(CC) -E $(COMMON_CFLAGS_$(ARCH))
242PP := $(CC) -E $(COMMON_CFLAGS_$(ARCH))
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200243
Jayanth Dodderi Chidanandd2a63642023-06-06 09:03:53 +0100244CLANG_WARNINGS += -nostdinc -ffreestanding -Wall \
245 -Wmissing-include-dirs $(CLANG_CFLAGS_$(ARCH)) \
246 -Wlogical-op-parentheses \
247 -Wno-initializer-overrides \
248 -Wno-sometimes-uninitialized \
249 -Wno-unused-function \
250 -Wno-unused-variable \
251 -Wno-unused-parameter \
252 -Wno-tautological-compare \
253 -Wno-memset-transposed-args \
254 -Wno-parentheses
255
256CLANG_CFLAGS += -Wno-error=deprecated-declarations \
257 -Wno-error=cpp \
258 $(CLANG_WARNINGS)
259endif #(clang)
260
261ifneq ($(findstring gcc,$(notdir $(CC))),)
262GCC_CFLAGS_aarch32 := ${march32-directive} -mno-unaligned-access
263GCC_CFLAGS_aarch64 := -mgeneral-regs-only
264
265GCC_ASFLAGS_aarch32 := ${march32-directive}
266GCC_ASFLAGS_aarch64 := -mgeneral-regs-only ${march64-directive}
267
268GCC_WARNINGS += -nostdinc -ffreestanding -Wall -Werror \
269 -Wmissing-include-dirs $(GCC_CFLAGS_$(ARCH)) \
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200270 -std=gnu99 -Os
Jayanth Dodderi Chidanandd2a63642023-06-06 09:03:53 +0100271
272# https://gcc.gnu.org/bugzilla/show_bug.cgi?id=105523
273GCC_CFLAGS += $(call cc_option, --param=min-pagesize=0)
274GCC_CFLAGS += $(GCC_WARNINGS)
275endif #(gcc)
276
277COMMON_CFLAGS_aarch64 += ${march64-directive} -mstrict-align \
278 $(CLANG_CFLAGS_$(ARCH)) $(GCC_CFLAGS_$(ARCH))
279
280COMMON_CFLAGS += $(COMMON_CFLAGS_$(ARCH))
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200281COMMON_CFLAGS += -ffunction-sections -fdata-sections
282
283# Get the content of CFLAGS user defined value last so they are appended after
284# the options defined in the Makefile
Jayanth Dodderi Chidanandd2a63642023-06-06 09:03:53 +0100285COMMON_CFLAGS += ${CLANG_CFLAGS} ${GCC_CFLAGS} ${INCLUDES}
286
287COMMON_ASFLAGS += -nostdinc -ffreestanding -Wa,--fatal-warnings \
288 -Werror -Wmissing-include-dirs \
289 -D__ASSEMBLY__ $(GCC_ASFLAGS_$(ARCH)) \
290 ${INCLUDES}
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200291
Karl Meakine69d1282023-03-07 17:10:07 +0000292COMMON_LDFLAGS += ${LDFLAGS} --fatal-warnings -O1 --gc-sections --build-id=none
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200293
Soby Mathew25d9e2f2023-05-05 10:51:57 +0100294# With ld.bfd version 2.39 and newer new warnings are added. Skip those since we
295# are not loaded by a elf loader.
296COMMON_LDFLAGS += $(call ld_option, --no-warn-rwx-segments)
297
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200298################################################################################
299
Mark Dykese7810b52020-06-03 15:46:55 -0500300TFTF_SOURCES := ${FRAMEWORK_SOURCES} ${TESTS_SOURCES} ${PLAT_SOURCES} ${LIBC_SRCS} ${LIBFDT_SRCS}
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200301TFTF_INCLUDES += ${PLAT_INCLUDES}
302TFTF_CFLAGS += ${COMMON_CFLAGS}
303TFTF_ASFLAGS += ${COMMON_ASFLAGS}
304TFTF_LDFLAGS += ${COMMON_LDFLAGS}
Mark Dykese7810b52020-06-03 15:46:55 -0500305TFTF_EXTRA_OBJS :=
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200306
Alexei Fedorov7fac1622020-06-19 14:25:43 +0100307ifneq (${BP_OPTION},none)
308TFTF_CFLAGS += -mbranch-protection=${BP_OPTION}
309NS_BL1U_CFLAGS += -mbranch-protection=${BP_OPTION}
310NS_BL2U_CFLAGS += -mbranch-protection=${BP_OPTION}
311CACTUS_MM_CFLAGS += -mbranch-protection=${BP_OPTION}
312CACTUS_CFLAGS += -mbranch-protection=${BP_OPTION}
313IVY_CFLAGS += -mbranch-protection=${BP_OPTION}
AlexeiFedorov193b3562022-12-22 16:50:08 +0000314REALM_CFLAGS += -mbranch-protection=${BP_OPTION}
Antonio Nino Diaz9c9f92c2019-03-13 13:57:39 +0000315endif
316
Mark Dykese7810b52020-06-03 15:46:55 -0500317ifeq ($(SMC_FUZZING), 1)
318TFTF_EXTRA_OBJS += ${BUILD_PLAT}/smcf/dtb.o
319endif
320
Olivier Deprez231115d2020-02-03 11:27:01 +0100321#####################################################################################
322ifneq ($(findstring gcc,$(notdir $(LD))),)
323 PIE_LDFLAGS += -Wl,-pie -Wl,--no-dynamic-linker
324else
325 PIE_LDFLAGS += -pie --no-dynamic-linker
326endif
327
328#####################################################################################
Ambroise Vincentd6e806d2019-02-11 14:34:26 +0000329NS_BL1U_SOURCES += ${PLAT_SOURCES} ${LIBC_SRCS}
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200330NS_BL1U_INCLUDES += ${PLAT_INCLUDES}
331NS_BL1U_CFLAGS += ${COMMON_CFLAGS}
332NS_BL1U_ASFLAGS += ${COMMON_ASFLAGS}
333NS_BL1U_LDFLAGS += ${COMMON_LDFLAGS}
334
Ambroise Vincentd6e806d2019-02-11 14:34:26 +0000335NS_BL2U_SOURCES += ${PLAT_SOURCES} ${LIBC_SRCS}
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200336NS_BL2U_INCLUDES += ${PLAT_INCLUDES}
337NS_BL2U_CFLAGS += ${COMMON_CFLAGS}
338NS_BL2U_ASFLAGS += ${COMMON_ASFLAGS}
339NS_BL2U_LDFLAGS += ${COMMON_LDFLAGS}
340
Antonio Nino Diazf2218e72019-03-19 10:59:11 +0000341CACTUS_MM_SOURCES += ${LIBC_SRCS}
342CACTUS_MM_INCLUDES += ${PLAT_INCLUDES}
343CACTUS_MM_CFLAGS += ${COMMON_CFLAGS}
344CACTUS_MM_ASFLAGS += ${COMMON_ASFLAGS}
345CACTUS_MM_LDFLAGS += ${COMMON_LDFLAGS}
346
Ambroise Vincentd6e806d2019-02-11 14:34:26 +0000347CACTUS_SOURCES += ${LIBC_SRCS}
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200348CACTUS_INCLUDES += ${PLAT_INCLUDES}
Olivier Deprez231115d2020-02-03 11:27:01 +0100349CACTUS_CFLAGS += ${COMMON_CFLAGS} -fpie
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200350CACTUS_ASFLAGS += ${COMMON_ASFLAGS}
Olivier Deprez231115d2020-02-03 11:27:01 +0100351CACTUS_LDFLAGS += ${COMMON_LDFLAGS} $(PIE_LDFLAGS)
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200352
Ambroise Vincentd6e806d2019-02-11 14:34:26 +0000353IVY_SOURCES += ${LIBC_SRCS}
Antonio Nino Diaz0b1ab402018-12-05 15:38:39 +0000354IVY_INCLUDES += ${PLAT_INCLUDES}
Ruari Phipps9f1952c2020-08-24 11:32:32 +0100355IVY_CFLAGS += ${COMMON_CFLAGS} -fpie
Antonio Nino Diaz0b1ab402018-12-05 15:38:39 +0000356IVY_ASFLAGS += ${COMMON_ASFLAGS}
Ruari Phipps9f1952c2020-08-24 11:32:32 +0100357IVY_LDFLAGS += ${COMMON_LDFLAGS} $(PIE_LDFLAGS)
Antonio Nino Diaz0b1ab402018-12-05 15:38:39 +0000358
nabkah01002e5692022-10-10 12:36:46 +0100359REALM_SOURCES += ${LIBC_SRCS}
360REALM_CFLAGS += ${COMMON_CFLAGS} -fpie
361REALM_ASFLAGS += ${COMMON_ASFLAGS}
362REALM_LDFLAGS += ${COMMON_LDFLAGS} $(PIE_LDFLAGS)
363
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200364.PHONY: locate-checkpatch
365locate-checkpatch:
366ifndef CHECKPATCH
367 $(error "Please set CHECKPATCH to point to the Linux checkpatch.pl file, eg: CHECKPATCH=../linux/script/checkpatch.pl")
368else
369ifeq (,$(wildcard ${CHECKPATCH}))
370 $(error "The file CHECKPATCH points to cannot be found, use eg: CHECKPATCH=../linux/script/checkpatch.pl")
371endif
372endif
373
374.PHONY: clean
375clean:
376 @echo " CLEAN"
377 ${Q}rm -rf ${BUILD_PLAT}
Shriram K86879852022-09-15 15:45:05 +0530378ifneq ($(wildcard ${EL3_PAYLOAD_PLAT_MAKEFILE_FULL}),)
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200379 ${MAKE} -C el3_payload clean
Shriram K86879852022-09-15 15:45:05 +0530380endif
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200381
382.PHONY: realclean distclean
383realclean distclean:
384 @echo " REALCLEAN"
385 ${Q}rm -rf ${BUILD_BASE}
386 ${Q}rm -f ${CURDIR}/cscope.*
Shriram K86879852022-09-15 15:45:05 +0530387ifneq ($(wildcard ${EL3_PAYLOAD_PLAT_MAKEFILE_FULL}),)
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200388 ${MAKE} -C el3_payload distclean
Shriram K86879852022-09-15 15:45:05 +0530389endif
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200390
391.PHONY: checkcodebase
392checkcodebase: locate-checkpatch
393 @echo " CHECKING STYLE"
394 @if test -d .git ; then \
Mark Dykese7810b52020-06-03 15:46:55 -0500395 git ls-files | grep -E -v 'libfdt|libc|docs|\.md|\.rst' | \
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200396 while read GIT_FILE ; \
397 do ${CHECKPATCH} ${CHECKCODE_ARGS} -f $$GIT_FILE ; \
398 done ; \
399 else \
400 find . -type f -not -iwholename "*.git*" \
401 -not -iwholename "*build*" \
Mark Dykese7810b52020-06-03 15:46:55 -0500402 -not -iwholename "*libfdt*" \
Ambroise Vincentd6e806d2019-02-11 14:34:26 +0000403 -not -iwholename "*libc*" \
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200404 -not -iwholename "*docs*" \
405 -not -iwholename "*.md" \
406 -not -iwholename "*.rst" \
407 -exec ${CHECKPATCH} ${CHECKCODE_ARGS} -f {} \; ; \
408 fi
409
410.PHONY: checkpatch
411checkpatch: locate-checkpatch
412 @echo " CHECKING STYLE"
413 ${Q}COMMON_COMMIT=$$(git merge-base HEAD ${BASE_COMMIT}); \
414 for commit in `git rev-list $$COMMON_COMMIT..HEAD`; do \
415 printf "\n[*] Checking style of '$$commit'\n\n"; \
416 git log --format=email "$$commit~..$$commit" \
417 -- ${CHECK_PATHS} | ${CHECKPATCH} - || true; \
418 git diff --format=email "$$commit~..$$commit" \
419 -- ${CHECK_PATHS} | ${CHECKPATCH} - || true; \
420 done
421
422ifneq (${FIRMWARE_UPDATE},1)
423.PHONY: ns_bl1u ns_bl2u
424ns_bl1u ns_bl2u:
425 @echo "ERROR: Can't build $@ because Firmware Update is not supported \
426 on this platform."
427 @exit 1
428endif
429
430ifneq (${ARCH}-${PLAT},aarch64-fvp)
Antonio Nino Diazf2218e72019-03-19 10:59:11 +0000431.PHONY: cactus_mm
432cactus_mm:
433 @echo "ERROR: $@ is supported only on AArch64 FVP."
434 @exit 1
435
nabkah01002e5692022-10-10 12:36:46 +0100436.PHONY: realm
437realm:
438 @echo "ERROR: $@ is supported only on AArch64 FVP."
439 @exit 1
440
441.PHONY: pack_realm
442pack_realm:
443 @echo "Nothing to be done"
444 @exit 1
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200445endif
446
Daniel Boulbyc19215a2023-05-17 13:50:36 +0100447ifneq (${ARCH}-${PLAT},$(filter ${ARCH}-${PLAT},aarch64-fvp aarch64-tc))
Arunachalam Ganapathy1e51c2f2020-09-22 13:28:29 +0100448.PHONY: cactus
449cactus:
Daniel Boulbyc19215a2023-05-17 13:50:36 +0100450 @echo "ERROR: $@ is supported only on AArch64 FVP or TC."
Arunachalam Ganapathy1e51c2f2020-09-22 13:28:29 +0100451 @exit 1
Olivier Deprez2765ebf2020-12-16 15:46:14 +0100452
453.PHONY: ivy
454ivy:
Daniel Boulbyc19215a2023-05-17 13:50:36 +0100455 @echo "ERROR: $@ is supported only on AArch64 FVP or TC."
Olivier Deprez2765ebf2020-12-16 15:46:14 +0100456 @exit 1
Arunachalam Ganapathy1e51c2f2020-09-22 13:28:29 +0100457endif
458
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200459MAKE_DEP = -Wp,-MD,$(DEP) -MT $$@
460
461define MAKE_C
462
463$(eval OBJ := $(1)/$(patsubst %.c,%.o,$(notdir $(2))))
464$(eval DEP := $(patsubst %.o,%.d,$(OBJ)))
465
Bence Szépkúti537b3582019-11-29 18:23:56 +0100466$(OBJ) : $(2) | $(AUTOGEN_DIR)/tests_list.h
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200467 @echo " CC $$<"
468 $$(Q)$$(CC) $$($(3)_CFLAGS) ${$(3)_INCLUDES} ${$(3)_DEFINES} -DIMAGE_$(3) $(MAKE_DEP) -c $$< -o $$@
469
470-include $(DEP)
471endef
472
473
474define MAKE_S
475
476$(eval OBJ := $(1)/$(patsubst %.S,%.o,$(notdir $(2))))
477$(eval DEP := $(patsubst %.o,%.d,$(OBJ)))
478
Bence Szépkúti537b3582019-11-29 18:23:56 +0100479$(OBJ) : $(2) | $(AUTOGEN_DIR)/tests_list.h
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200480 @echo " AS $$<"
481 $$(Q)$$(AS) $$($(3)_ASFLAGS) ${$(3)_INCLUDES} ${$(3)_DEFINES} -DIMAGE_$(3) $(MAKE_DEP) -c $$< -o $$@
482
483-include $(DEP)
484endef
485
486
487define MAKE_LD
488
489$(eval DEP := $(1).d)
490
Bence Szépkúti537b3582019-11-29 18:23:56 +0100491$(1) : $(2) | $(AUTOGEN_DIR)/tests_list.h
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200492 @echo " PP $$<"
493 $$(Q)$$(AS) $$($(3)_ASFLAGS) ${$(3)_INCLUDES} ${$(3)_DEFINES} -P -E $(MAKE_DEP) -o $$@ $$<
494
495-include $(DEP)
496endef
497
498
499define MAKE_OBJS
500 $(eval C_OBJS := $(filter %.c,$(2)))
501 $(eval REMAIN := $(filter-out %.c,$(2)))
502 $(eval $(foreach obj,$(C_OBJS),$(call MAKE_C,$(1),$(obj),$(3))))
503
504 $(eval S_OBJS := $(filter %.S,$(REMAIN)))
505 $(eval REMAIN := $(filter-out %.S,$(REMAIN)))
506 $(eval $(foreach obj,$(S_OBJS),$(call MAKE_S,$(1),$(obj),$(3))))
507
508 $(and $(REMAIN),$(error Unexpected source files present: $(REMAIN)))
509endef
510
511
512# NOTE: The line continuation '\' is required in the next define otherwise we
513# end up with a line-feed characer at the end of the last c filename.
514# Also bare this issue in mind if extending the list of supported filetypes.
515define SOURCES_TO_OBJS
516 $(notdir $(patsubst %.c,%.o,$(filter %.c,$(1)))) \
517 $(notdir $(patsubst %.S,%.o,$(filter %.S,$(1))))
518endef
519
520define uppercase
521$(shell echo $(1) | tr '[:lower:]' '[:upper:]')
522endef
523
524define MAKE_IMG
525 $(eval IMG_PREFIX := $(call uppercase, $(1)))
526 $(eval BUILD_DIR := ${BUILD_PLAT}/$(1))
527 $(eval SOURCES := $(${IMG_PREFIX}_SOURCES))
528 $(eval OBJS := $(addprefix $(BUILD_DIR)/,$(call SOURCES_TO_OBJS,$(SOURCES))))
Mark Dykese7810b52020-06-03 15:46:55 -0500529 $(eval OBJS += $(${IMG_PREFIX}_EXTRA_OBJS))
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200530 $(eval LINKERFILE := $(BUILD_DIR)/$(1).ld)
531 $(eval MAPFILE := $(BUILD_DIR)/$(1).map)
532 $(eval ELF := $(BUILD_DIR)/$(1).elf)
533 $(eval DUMP := $(BUILD_DIR)/$(1).dump)
534 $(eval BIN := $(BUILD_PLAT)/$(1).bin)
535
536 $(eval $(call MAKE_OBJS,$(BUILD_DIR),$(SOURCES),${IMG_PREFIX}))
537 $(eval $(call MAKE_LD,$(LINKERFILE),$(${IMG_PREFIX}_LINKERFILE),${IMG_PREFIX}))
538
539$(BUILD_DIR) :
540 $$(Q)mkdir -p "$$@"
541
542$(ELF) : $(OBJS) $(LINKERFILE)
543 @echo " LD $$@"
544 @echo 'const char build_message[] = "Built : "__TIME__", "__DATE__; \
545 const char version_string[] = "${VERSION_STRING}";' | \
546 $$(CC) $$(${IMG_PREFIX}_CFLAGS) ${${IMG_PREFIX}_INCLUDES} ${${IMG_PREFIX}_DEFINES} -c -xc - -o $(BUILD_DIR)/build_message.o
547 $$(Q)$$(LD) -o $$@ $$(${IMG_PREFIX}_LDFLAGS) -Map=$(MAPFILE) \
548 -T $(LINKERFILE) $(BUILD_DIR)/build_message.o $(OBJS)
549
550$(DUMP) : $(ELF)
551 @echo " OD $$@"
552 $${Q}$${OD} -dx $$< > $$@
553
554$(BIN) : $(ELF)
555 @echo " BIN $$@"
556 $$(Q)$$(OC) -O binary $$< $$@
557 @echo
558 @echo "Built $$@ successfully"
559 @echo
560
561.PHONY : $(1)
562$(1) : $(BUILD_DIR) $(BIN) $(DUMP)
563
564all : $(1)
565
566endef
567
Shruti Gupta2eb601b2023-03-29 21:35:17 +0100568ifeq (${ARCH},aarch32)
569 ARCH_TESTS_SKIP_LIST := tftf/tests/aarch32_tests_to_skip.txt
570endif
571
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200572$(AUTOGEN_DIR):
573 $(Q)mkdir -p "$@"
574
Shruti Gupta2eb601b2023-03-29 21:35:17 +0100575$(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 +0200576 @echo " AUTOGEN $@"
Jim Ray7ba27bf2023-05-25 14:11:51 -0700577 tools/generate_test_list/generate_test_list.py $(AUTOGEN_DIR)/tests_list.c \
578 $(AUTOGEN_DIR)/tests_list.h ${TESTS_FILE} \
579 --plat-skip-file=$(PLAT_TESTS_SKIP_LIST) \
580 --arch-skip-file=$(ARCH_TESTS_SKIP_LIST)
Mark Dykese7810b52020-06-03 15:46:55 -0500581ifeq ($(SMC_FUZZING), 1)
582 $(Q)mkdir -p ${BUILD_PLAT}/smcf
583 dtc ${SMC_FUZZ_DTS} >> ${BUILD_PLAT}/smcf/dtb
584 $(OC) -I binary -O elf64-littleaarch64 -B aarch64 ${BUILD_PLAT}/smcf/dtb ${BUILD_PLAT}/smcf/dtb.o \
johpow01d5c79cc2021-06-23 16:10:22 -0500585 --redefine-sym _binary___build_$(PLAT)_$(BUILD_TYPE)_smcf_dtb_start=_binary___dtb_start \
586 --redefine-sym _binary___build_$(PLAT)_$(BUILD_TYPE)_smcf_dtb_end=_binary___dtb_end
Mark Dykese7810b52020-06-03 15:46:55 -0500587endif
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200588
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200589ifeq ($(FIRMWARE_UPDATE), 1)
590 $(eval $(call MAKE_IMG,ns_bl1u))
591 $(eval $(call MAKE_IMG,ns_bl2u))
592endif
593
594ifeq (${ARCH}-${PLAT},aarch64-fvp)
Antonio Nino Diazf2218e72019-03-19 10:59:11 +0000595 $(eval $(call MAKE_IMG,cactus_mm))
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200596 $(eval $(call MAKE_IMG,cactus))
Antonio Nino Diaz0b1ab402018-12-05 15:38:39 +0000597 $(eval $(call MAKE_IMG,ivy))
Shruti Guptac973b2a2023-07-12 12:10:54 +0100598endif
599
600ifeq (${ENABLE_REALM_PAYLOAD_TESTS},1)
nabkah01002e5692022-10-10 12:36:46 +0100601 $(eval $(call MAKE_IMG,realm))
602endif
603
Shruti Guptac973b2a2023-07-12 12:10:54 +0100604.PHONY : tftf
605 $(eval $(call MAKE_IMG,tftf))
606
607ifeq (${ENABLE_REALM_PAYLOAD_TESTS},1)
608tftf: realm
609 @echo " PACK REALM PAYLOAD"
610 $(shell dd if=$(BUILD_PLAT)/realm.bin of=$(BUILD_PLAT)/tftf.bin obs=1 \
Soby Mathew6e5c9962023-10-06 16:38:13 +0100611 oflag=append conv=notrunc)
Shruti Guptac973b2a2023-07-12 12:10:54 +0100612endif
613
nabkah01002e5692022-10-10 12:36:46 +0100614ifeq (${ARCH}-${PLAT},aarch64-fvp)
615.PHONY : pack_realm
Shruti Guptac973b2a2023-07-12 12:10:54 +0100616$(eval $(call MAKE_IMG,realm))
nabkah01002e5692022-10-10 12:36:46 +0100617pack_realm: realm tftf
618 @echo " PACK REALM PAYLOAD"
619 $(shell dd if=$(BUILD_PLAT)/realm.bin of=$(BUILD_PLAT)/tftf.bin obs=1 \
Soby Mathew6e5c9962023-10-06 16:38:13 +0100620 oflag=append conv=notrunc)
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200621endif
622
Daniel Boulbyc19215a2023-05-17 13:50:36 +0100623ifeq (${ARCH}-${PLAT},aarch64-tc)
Arunachalam Ganapathy1e51c2f2020-09-22 13:28:29 +0100624 $(eval $(call MAKE_IMG,cactus))
Olivier Deprez2765ebf2020-12-16 15:46:14 +0100625 $(eval $(call MAKE_IMG,ivy))
Arunachalam Ganapathy1e51c2f2020-09-22 13:28:29 +0100626endif
627
Daniel Boulbyf6c288e2022-07-25 14:07:57 +0100628SP_LAYOUT:
629 ${Q}tools/generate_json/generate_json.sh \
630 $(BUILD_PLAT) $(SECURE_PARTITIONS)
631
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200632# The EL3 test payload is only supported in AArch64. It has an independent build
633# system.
634.PHONY: el3_payload
Jayanth Dodderi Chidanandd2a63642023-06-06 09:03:53 +0100635# TODO: EL3 test payload currently is supported for GCC only. It has an independent
636# build system and support for Clang to be added.
637ifneq ($(findstring gcc,$(notdir $(CC))),)
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200638ifneq (${ARCH},aarch32)
Arvind Ram Prakash2e1264d2022-05-20 12:27:40 -0500639ifneq ($(wildcard ${EL3_PAYLOAD_PLAT_MAKEFILE_FULL}),)
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200640el3_payload: $(BUILD_DIR)
641 ${Q}${MAKE} -C el3_payload PLAT=${PLAT}
642 ${Q}find "el3_payload/build/${PLAT}" -name '*.bin' -exec cp {} "${BUILD_PLAT}" \;
643
644all: el3_payload
645endif
Arvind Ram Prakash2e1264d2022-05-20 12:27:40 -0500646endif
Jayanth Dodderi Chidanandd2a63642023-06-06 09:03:53 +0100647endif
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200648
Sandrine Bailleuxf8228af2020-04-21 14:45:00 +0200649doc:
650 @echo " BUILD DOCUMENTATION"
651 ${Q}${MAKE} --no-print-directory -C ${DOCS_PATH} html
652
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200653.PHONY: cscope
654cscope:
655 @echo " CSCOPE"
656 ${Q}find ${CURDIR} -name "*.[chsS]" > cscope.files
657 ${Q}cscope -b -q -k
658
659.PHONY: help
Leonardo Sandoval770b4312020-09-11 14:44:40 -0500660.SILENT: help
Sandrine Bailleux3cd87d72018-10-09 11:12:55 +0200661help:
Leonardo Sandoval770b4312020-09-11 14:44:40 -0500662 echo "usage: ${MAKE} PLAT=<${PLATFORMS}> \
Shruti Guptac973b2a2023-07-12 12:10:54 +0100663<all|tftf|ns_bl1u|ns_bl2u|cactus|ivy|el3_payload|distclean|clean|checkcodebase|checkpatch|help_tests>"
Leonardo Sandoval770b4312020-09-11 14:44:40 -0500664 echo ""
665 echo "PLAT is used to specify which platform you wish to build."
666 echo "If no platform is specified, PLAT defaults to: ${DEFAULT_PLAT}"
667 echo ""
668 echo "Supported Targets:"
669 echo " all Build all supported binaries for this platform"
670 echo " (i.e. TFTF and FWU images)"
671 echo " tftf Build the TFTF image"
672 echo " ns_bl1u Build the NS_BL1U image"
673 echo " ns_bl2u Build the NS_BL2U image"
Olivier Deprez40777f82022-11-09 10:15:28 +0100674 echo " cactus Build the Cactus image (FF-A S-EL1 test payload)."
675 echo " cactus_mm Build the Cactus-MM image (SPM-MM S-EL0 test payload)."
676 echo " ivy Build the Ivy image (FF-A S-EL0 test payload)."
Leonardo Sandoval770b4312020-09-11 14:44:40 -0500677 echo " el3_payload Build the EL3 test payload"
678 echo " checkcodebase Check the coding style of the entire source tree"
679 echo " checkpatch Check the coding style on changes in the current"
680 echo " branch against BASE_COMMIT (default origin/master)"
681 echo " doc Build html based documentation using Sphinx tool"
682 echo " clean Clean the build for the selected platform"
683 echo " cscope Generate cscope index"
684 echo " distclean Remove all build artifacts for all platforms"
685 echo " help_tests List all possible sets of tests"
686 echo ""
687 echo "note: most build targets require PLAT to be set to a specific platform."
688 echo ""
689 echo "example: build all targets for the FVP platform:"
690 echo " CROSS_COMPILE=aarch64-none-elf- make PLAT=fvp all"