blob: 777e3308e73788e0ff64ca09b54d2af7cd3ff1da [file] [log] [blame]
Achin Gupta4f6ad662013-10-25 09:08:21 +01001#
Dan Handleye83b0ca2014-01-14 18:17:09 +00002# Copyright (c) 2013-2014, ARM Limited and Contributors. All rights reserved.
Achin Gupta4f6ad662013-10-25 09:08:21 +01003#
4# Redistribution and use in source and binary forms, with or without
5# modification, are permitted provided that the following conditions are met:
6#
7# Redistributions of source code must retain the above copyright notice, this
8# list of conditions and the following disclaimer.
9#
10# Redistributions in binary form must reproduce the above copyright notice,
11# this list of conditions and the following disclaimer in the documentation
12# and/or other materials provided with the distribution.
13#
14# Neither the name of ARM nor the names of its contributors may be used
15# to endorse or promote products derived from this software without specific
16# prior written permission.
17#
18# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
19# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
22# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
23# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
24# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
25# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
26# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
27# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
28# POSSIBILITY OF SUCH DAMAGE.
29#
30
Jeenu Viswambharan19a0ace2014-05-15 14:40:58 +010031#
Juan Castillo04be3a52014-06-30 11:41:46 +010032# Trusted Firmware Version
33#
Dan Handley98b6b5d2014-08-26 19:18:55 +010034VERSION_MAJOR := 1
35VERSION_MINOR := 0
Juan Castillo04be3a52014-06-30 11:41:46 +010036
37#
Jeenu Viswambharan19a0ace2014-05-15 14:40:58 +010038# Default values for build configurations
39#
40
41# Build verbosity
42V := 0
43# Debug build
44DEBUG := 0
45# Build architecture
46ARCH := aarch64
47# Build platform
48DEFAULT_PLAT := fvp
49PLAT := ${DEFAULT_PLAT}
50# SPD choice
51SPD := none
52# Base commit to perform code check on
53BASE_COMMIT := origin/master
Jeenu Viswambharand1b60152014-05-12 15:28:47 +010054# NS timer register save and restore
55NS_TIMER_SWITCH := 0
Vikram Kanigiri96377452014-04-24 11:02:16 +010056# By default, Bl1 acts as the reset handler, not BL31
57RESET_TO_BL31 := 0
Juan Castillo258e94f2014-06-25 17:26:36 +010058# Include FP registers in cpu context
59CTX_INCLUDE_FPREGS := 0
Sandrine Bailleux5fe57c12014-07-17 17:23:14 +010060# Determine the version of ARM GIC architecture to use for interrupt management
61# in EL3. The platform port can change this value if needed.
62ARM_GIC_ARCH := 2
Soby Mathew041f62a2014-07-14 16:58:03 +010063# Flag used to indicate if ASM_ASSERTION should be enabled for the build.
64# This defaults to being present in DEBUG builds only.
65ASM_ASSERTION := ${DEBUG}
Soby Mathew523d6332015-01-08 18:02:19 +000066# Build option to choose whether Trusted firmware uses Coherent memory or not.
67USE_COHERENT_MEM := 1
Juan Castillo860cc3b2014-11-24 11:45:12 +000068# Default FIP file name
69FIP_NAME := fip.bin
Juan Castillo11abdcd2014-10-21 11:30:42 +010070# Flags to generate the Chain of Trust
71GENERATE_COT := 0
72CREATE_KEYS := 1
Achin Gupta4f6ad662013-10-25 09:08:21 +010073
Achin Gupta7421b462014-02-01 18:53:26 +000074# Checkpatch ignores
75CHECK_IGNORE = --ignore COMPLEX_MACRO
76
77CHECKPATCH_ARGS = --no-tree --no-signoff ${CHECK_IGNORE}
78CHECKCODE_ARGS = --no-patch --no-tree --no-signoff ${CHECK_IGNORE}
Ian Spray36eaaf32014-01-30 17:25:28 +000079
Jeenu Viswambharan19a0ace2014-05-15 14:40:58 +010080ifeq (${V},0)
Achin Gupta4f6ad662013-10-25 09:08:21 +010081 Q=@
Ian Spray36eaaf32014-01-30 17:25:28 +000082 CHECKCODE_ARGS += --no-summary --terse
Achin Gupta4f6ad662013-10-25 09:08:21 +010083else
84 Q=
85endif
Jeenu Viswambharan2f2cef42014-02-19 09:38:18 +000086export Q
87
James Morrisseyeaaeece2013-11-01 13:56:59 +000088ifneq (${DEBUG}, 0)
89 BUILD_TYPE := debug
Dan Handleycba2c502014-08-08 14:36:42 +010090 # Use LOG_LEVEL_INFO by default for debug builds
91 LOG_LEVEL := 40
James Morrisseyeaaeece2013-11-01 13:56:59 +000092else
93 BUILD_TYPE := release
Dan Handleycba2c502014-08-08 14:36:42 +010094 # Use LOG_LEVEL_NOTICE by default for release builds
95 LOG_LEVEL := 20
James Morrisseyeaaeece2013-11-01 13:56:59 +000096endif
97
Juan Castillo04be3a52014-06-30 11:41:46 +010098# Default build string (git branch and commit)
99ifeq (${BUILD_STRING},)
100 BUILD_STRING := $(shell git log -n 1 --pretty=format:"%h")
101endif
102
103VERSION_STRING := v${VERSION_MAJOR}.${VERSION_MINOR}(${BUILD_TYPE}):${BUILD_STRING}
104
Dan Handley176e7b42014-04-15 18:20:09 +0100105BL_COMMON_SOURCES := common/bl_common.c \
Soby Mathewafe7e2f2014-06-12 17:23:58 +0100106 common/tf_printf.c \
Soby Mathewc1adbbc2014-06-25 10:07:40 +0100107 common/aarch64/debug.S \
Dan Handley176e7b42014-04-15 18:20:09 +0100108 lib/aarch64/cache_helpers.S \
109 lib/aarch64/misc_helpers.S \
Dan Handley176e7b42014-04-15 18:20:09 +0100110 lib/aarch64/xlat_helpers.c \
111 lib/stdlib/std.c \
Dan Handley176e7b42014-04-15 18:20:09 +0100112 plat/common/aarch64/platform_helpers.S
Ryan Harkind7a6b0f2014-01-13 14:40:13 +0000113
Ryan Harkin25cff832014-01-13 12:37:03 +0000114BUILD_BASE := ./build
115BUILD_PLAT := ${BUILD_BASE}/${PLAT}/${BUILD_TYPE}
Achin Gupta4f6ad662013-10-25 09:08:21 +0100116
Ryan Harkin25cff832014-01-13 12:37:03 +0000117PLATFORMS := $(shell ls -I common plat/)
Achin Gupta375f5382014-02-18 18:12:48 +0000118SPDS := $(shell ls -I none services/spd)
Ryan Harkin72ee3312014-01-15 16:55:07 +0000119HELP_PLATFORMS := $(shell echo ${PLATFORMS} | sed 's/ /|/g')
120
Jeenu Viswambharane5c39fd2014-05-16 11:38:10 +0100121# Convenience function for adding build definitions
122# $(eval $(call add_define,FOO)) will have:
123# -DFOO if $(FOO) is empty; -DFOO=$(FOO) otherwise
124define add_define
125DEFINES += -D$(1)$(if $(value $(1)),=$(value $(1)),)
126endef
127
128# Convenience function for verifying option has a boolean value
129# $(eval $(call assert_boolean,FOO)) will assert FOO is 0 or 1
130define assert_boolean
131$(and $(patsubst 0,,$(value $(1))),$(patsubst 1,,$(value $(1))),$(error $(1) must be boolean))
132endef
133
Ryan Harkin25cff832014-01-13 12:37:03 +0000134ifeq (${PLAT},)
135 $(error "Error: Unknown platform. Please use PLAT=<platform name> to specify the platform.")
136endif
Jon Medhurst66573cb2014-02-13 15:19:28 +0000137ifeq ($(findstring ${PLAT},${PLATFORMS}),)
Ryan Harkin25cff832014-01-13 12:37:03 +0000138 $(error "Error: Invalid platform. The following platforms are available: ${PLATFORMS}")
139endif
140
Jon Medhurst66573cb2014-02-13 15:19:28 +0000141all: msg_start
Achin Gupta4f6ad662013-10-25 09:08:21 +0100142
Ryan Harkin25cff832014-01-13 12:37:03 +0000143msg_start:
144 @echo "Building ${PLAT}"
Achin Gupta4f6ad662013-10-25 09:08:21 +0100145
Jon Medhurst66573cb2014-02-13 15:19:28 +0000146include plat/${PLAT}/platform.mk
147
Soby Mathew937488b2014-09-22 14:13:34 +0100148# Include the CPU specific operations makefile. By default all CPU errata
149# workarounds and CPU specifc optimisations are disabled. This can be
Soby Mathew802f8652014-08-14 16:19:29 +0100150# overridden by the platform.
Soby Mathew937488b2014-09-22 14:13:34 +0100151include lib/cpus/cpu-ops.mk
Soby Mathew802f8652014-08-14 16:19:29 +0100152
Jon Medhurst66573cb2014-02-13 15:19:28 +0000153ifdef BL1_SOURCES
154NEED_BL1 := yes
155include bl1/bl1.mk
156endif
157
158ifdef BL2_SOURCES
159NEED_BL2 := yes
160include bl2/bl2.mk
Soby Mathewdbee7fc2014-09-08 17:51:01 +0100161# Using the ARM Trusted Firmware BL2 implies that a BL3-3 image also need to be supplied for the FIP.
162# This flag can be overridden by the platform.
163NEED_BL33 ?= yes
Jon Medhurst66573cb2014-02-13 15:19:28 +0000164endif
Achin Gupta4f6ad662013-10-25 09:08:21 +0100165
Jon Medhurst66573cb2014-02-13 15:19:28 +0000166ifdef BL31_SOURCES
167NEED_BL31 := yes
168include bl31/bl31.mk
Ryan Harkin25cff832014-01-13 12:37:03 +0000169endif
Achin Gupta4f6ad662013-10-25 09:08:21 +0100170
Achin Gupta375f5382014-02-18 18:12:48 +0000171# Include SPD Makefile if one has been specified
172ifneq (${SPD},none)
173 # We expect to locate an spd.mk under the specified SPD directory
174 SPD_MAKE := $(shell m="services/spd/${SPD}/${SPD}.mk"; [ -f "$$m" ] && echo "$$m")
175
176 ifeq (${SPD_MAKE},)
177 $(error Error: No services/spd/${SPD}/${SPD}.mk located)
178 endif
179 $(info Including ${SPD_MAKE})
180 include ${SPD_MAKE}
181
Soby Mathewdbee7fc2014-09-08 17:51:01 +0100182 # If there's BL3-2 companion for the chosen SPD, and the SPD wants to build the
183 # BL3-2 from source, we expect that the SPD's Makefile would set NEED_BL32
184 # variable to "yes". In case the BL3-2 is a binary which needs to be included in
185 # fip, then the NEED_BL32 needs to be set and BL3-2 would need to point to the bin.
Achin Gupta375f5382014-02-18 18:12:48 +0000186endif
187
Juan Castillo11abdcd2014-10-21 11:30:42 +0100188.PHONY: all msg_start clean realclean distclean cscope locate-checkpatch checkcodebase checkpatch fiptool fip certtool
James Morrisseyeaaeece2013-11-01 13:56:59 +0000189.SUFFIXES:
190
Sandrine Bailleux47e74a82014-06-23 13:37:53 +0100191INCLUDES += -Iinclude/bl31 \
Dan Handleya70615f2014-04-09 12:48:25 +0100192 -Iinclude/bl31/services \
Dan Handleya70615f2014-04-09 12:48:25 +0100193 -Iinclude/common \
194 -Iinclude/drivers \
195 -Iinclude/drivers/arm \
Dan Handley7b83c442014-08-12 14:20:28 +0100196 -Iinclude/drivers/io \
Dan Handleya70615f2014-04-09 12:48:25 +0100197 -Iinclude/lib \
198 -Iinclude/lib/aarch64 \
Soby Mathew8e2f2872014-08-14 12:49:05 +0100199 -Iinclude/lib/cpus/aarch64 \
Dan Handleyed6ff952014-05-14 17:44:19 +0100200 -Iinclude/plat/common \
Ryan Harkind7a6b0f2014-01-13 14:40:13 +0000201 -Iinclude/stdlib \
202 -Iinclude/stdlib/sys \
Achin Gupta375f5382014-02-18 18:12:48 +0000203 ${PLAT_INCLUDES} \
204 ${SPD_INCLUDES}
Achin Gupta4f6ad662013-10-25 09:08:21 +0100205
Jeenu Viswambharan19a0ace2014-05-15 14:40:58 +0100206# Process DEBUG flag
207$(eval $(call assert_boolean,DEBUG))
208$(eval $(call add_define,DEBUG))
209ifeq (${DEBUG},0)
210 $(eval $(call add_define,NDEBUG))
211else
212CFLAGS += -g
213ASFLAGS += -g -Wa,--gdwarf-2
214endif
215
Jeenu Viswambharand1b60152014-05-12 15:28:47 +0100216# Process NS_TIMER_SWITCH flag
217$(eval $(call assert_boolean,NS_TIMER_SWITCH))
218$(eval $(call add_define,NS_TIMER_SWITCH))
219
Vikram Kanigiri96377452014-04-24 11:02:16 +0100220# Process RESET_TO_BL31 flag
221$(eval $(call assert_boolean,RESET_TO_BL31))
222$(eval $(call add_define,RESET_TO_BL31))
223
Juan Castillo258e94f2014-06-25 17:26:36 +0100224# Process CTX_INCLUDE_FPREGS flag
225$(eval $(call assert_boolean,CTX_INCLUDE_FPREGS))
226$(eval $(call add_define,CTX_INCLUDE_FPREGS))
227
Sandrine Bailleux5fe57c12014-07-17 17:23:14 +0100228# Process ARM_GIC_ARCH flag
229$(eval $(call add_define,ARM_GIC_ARCH))
230
Soby Mathew041f62a2014-07-14 16:58:03 +0100231# Process ASM_ASSERTION flag
232$(eval $(call assert_boolean,ASM_ASSERTION))
233$(eval $(call add_define,ASM_ASSERTION))
Sandrine Bailleux5fe57c12014-07-17 17:23:14 +0100234
Dan Handleycba2c502014-08-08 14:36:42 +0100235# Process LOG_LEVEL flag
236$(eval $(call add_define,LOG_LEVEL))
237
Soby Mathew523d6332015-01-08 18:02:19 +0000238# Process USE_COHERENT_MEM flag
239$(eval $(call assert_boolean,USE_COHERENT_MEM))
240$(eval $(call add_define,USE_COHERENT_MEM))
241
Juan Castillo11abdcd2014-10-21 11:30:42 +0100242# Process Generate CoT flags
243$(eval $(call assert_boolean,GENERATE_COT))
244$(eval $(call assert_boolean,CREATE_KEYS))
245
Harry Liebel0af6d642013-12-20 18:51:12 +0000246ASFLAGS += -nostdinc -ffreestanding -Wa,--fatal-warnings \
Sandrine Bailleux47e74a82014-06-23 13:37:53 +0100247 -Werror -Wmissing-include-dirs \
Jeenu Viswambharan19a0ace2014-05-15 14:40:58 +0100248 -mgeneral-regs-only -D__ASSEMBLY__ \
249 ${DEFINES} ${INCLUDES}
250CFLAGS += -nostdinc -pedantic -ffreestanding -Wall \
Sandrine Bailleux47e74a82014-06-23 13:37:53 +0100251 -Werror -Wmissing-include-dirs \
252 -mgeneral-regs-only -std=c99 -c -Os \
Jeenu Viswambharan19a0ace2014-05-15 14:40:58 +0100253 ${DEFINES} ${INCLUDES}
Andrew Thoelkee01ea342014-03-18 07:13:52 +0000254CFLAGS += -ffunction-sections -fdata-sections
Achin Gupta4f6ad662013-10-25 09:08:21 +0100255
Sandrine Bailleux3e850a82013-11-20 11:50:48 +0000256LDFLAGS += --fatal-warnings -O1
Andrew Thoelkee01ea342014-03-18 07:13:52 +0000257LDFLAGS += --gc-sections
Achin Gupta4f6ad662013-10-25 09:08:21 +0100258
259
James Morrisseyeaaeece2013-11-01 13:56:59 +0000260CC := ${CROSS_COMPILE}gcc
261CPP := ${CROSS_COMPILE}cpp
262AS := ${CROSS_COMPILE}gcc
263AR := ${CROSS_COMPILE}ar
264LD := ${CROSS_COMPILE}ld
265OC := ${CROSS_COMPILE}objcopy
266OD := ${CROSS_COMPILE}objdump
267NM := ${CROSS_COMPILE}nm
268PP := ${CROSS_COMPILE}gcc -E ${CFLAGS}
Achin Gupta4f6ad662013-10-25 09:08:21 +0100269
Harry Liebelf58ad362014-01-10 18:00:33 +0000270# Variables for use with Firmware Image Package
271FIPTOOLPATH ?= tools/fip_create
Achin Gupta375f5382014-02-18 18:12:48 +0000272FIPTOOL ?= ${FIPTOOLPATH}/fip_create
Harry Liebelf58ad362014-01-10 18:00:33 +0000273fiptool: ${FIPTOOL}
Juan Castillo860cc3b2014-11-24 11:45:12 +0000274fip: ${BUILD_PLAT}/${FIP_NAME}
Harry Liebelf58ad362014-01-10 18:00:33 +0000275
Juan Castillo11abdcd2014-10-21 11:30:42 +0100276# Variables for use with Certificate Generation Tool
277CRTTOOLPATH ?= tools/cert_create
278CRTTOOL ?= ${CRTTOOLPATH}/cert_create
279certtool: ${CRTTOOL}
280
281# CoT generation tool default parameters
282TRUSTED_KEY_CERT := ${BUILD_PLAT}/trusted_key.crt
283
284# Pass the private keys to the CoT generation tool in the command line
285# If CREATE_KEYS is set, the '-n' option will be added, indicating the tool to create new keys
286ifneq (${GENERATE_COT},0)
287 $(eval CERTS := yes)
288
289 ifneq (${CREATE_KEYS},0)
290 $(eval CRT_ARGS += -n)
291 endif
292 $(eval CRT_ARGS += $(if ${ROT_KEY}, --rot-key ${ROT_KEY}))
293 $(eval CRT_ARGS += $(if ${TRUSTED_WORLD_KEY}, --trusted-world-key ${TRUSTED_WORLD_KEY}))
294 $(eval CRT_ARGS += $(if ${NON_TRUSTED_WORLD_KEY}, --non-trusted-world-key ${NON_TRUSTED_WORLD_KEY}))
295 $(eval CRT_ARGS += --trusted-key-cert ${TRUSTED_KEY_CERT})
296endif
297
Ian Spray36eaaf32014-01-30 17:25:28 +0000298locate-checkpatch:
299ifndef CHECKPATCH
300 $(error "Please set CHECKPATCH to point to the Linux checkpatch.pl file, eg: CHECKPATCH=../linux/script/checkpatch.pl")
301else
302ifeq (,$(wildcard ${CHECKPATCH}))
303 $(error "The file CHECKPATCH points to cannot be found, use eg: CHECKPATCH=../linux/script/checkpatch.pl")
304endif
305endif
306
Achin Gupta4f6ad662013-10-25 09:08:21 +0100307clean:
308 @echo " CLEAN"
Ryan Harkin25cff832014-01-13 12:37:03 +0000309 ${Q}rm -rf ${BUILD_PLAT}
Jeenu Viswambharan2f2cef42014-02-19 09:38:18 +0000310 ${Q}${MAKE} --no-print-directory -C ${FIPTOOLPATH} clean
Juan Castillo11abdcd2014-10-21 11:30:42 +0100311 ${Q}${MAKE} PLAT=${PLAT} --no-print-directory -C ${CRTTOOLPATH} clean
Achin Gupta4f6ad662013-10-25 09:08:21 +0100312
James Morrisseyeaaeece2013-11-01 13:56:59 +0000313realclean distclean:
314 @echo " REALCLEAN"
315 ${Q}rm -rf ${BUILD_BASE}
Joakim Bech35fab8c2014-01-23 14:51:49 +0100316 ${Q}rm -f ${CURDIR}/cscope.*
Jeenu Viswambharan2f2cef42014-02-19 09:38:18 +0000317 ${Q}${MAKE} --no-print-directory -C ${FIPTOOLPATH} clean
Juan Castillo11abdcd2014-10-21 11:30:42 +0100318 ${Q}${MAKE} PLAT=${PLAT} --no-print-directory -C ${CRTTOOLPATH} clean
Achin Gupta4f6ad662013-10-25 09:08:21 +0100319
Ian Spray36eaaf32014-01-30 17:25:28 +0000320checkcodebase: locate-checkpatch
321 @echo " CHECKING STYLE"
322 @if test -d .git ; then \
Juan Castillo2d552402014-06-13 17:05:10 +0100323 git ls-files | grep -v stdlib | while read GIT_FILE ; do ${CHECKPATCH} ${CHECKCODE_ARGS} -f $$GIT_FILE ; done ; \
Ian Spray36eaaf32014-01-30 17:25:28 +0000324 else \
Juan Castillo2d552402014-06-13 17:05:10 +0100325 find . -type f -not -iwholename "*.git*" -not -iwholename "*build*" -not -iwholename "*stdlib*" -exec ${CHECKPATCH} ${CHECKCODE_ARGS} -f {} \; ; \
Ian Spray36eaaf32014-01-30 17:25:28 +0000326 fi
327
328checkpatch: locate-checkpatch
329 @echo " CHECKING STYLE"
330 @git format-patch --stdout ${BASE_COMMIT} | ${CHECKPATCH} ${CHECKPATCH_ARGS} - || true
331
Juan Castillo11abdcd2014-10-21 11:30:42 +0100332.PHONY: ${CRTTOOL}
333${CRTTOOL}:
334 ${Q}${MAKE} PLAT=${PLAT} --no-print-directory -C ${CRTTOOLPATH}
335 @echo
336 @echo "Built $@ successfully"
337 @echo
338
Sandrine Bailleux152c17f2014-10-27 17:10:46 +0000339.PHONY: ${FIPTOOL}
Harry Liebelf58ad362014-01-10 18:00:33 +0000340${FIPTOOL}:
Jeenu Viswambharan2f2cef42014-02-19 09:38:18 +0000341 ${Q}${MAKE} --no-print-directory -C ${FIPTOOLPATH}
Harry Liebelf58ad362014-01-10 18:00:33 +0000342
Jon Medhurst407a95c2014-02-12 15:54:48 +0000343define match_goals
344$(strip $(foreach goal,$(1),$(filter $(goal),$(MAKECMDGOALS))))
345endef
Achin Gupta4f6ad662013-10-25 09:08:21 +0100346
Sandrine Bailleux2d3e42d2014-03-21 14:17:51 +0000347# List of rules that involve building things
348BUILD_TARGETS := all bl1 bl2 bl31 bl32 fip
James Morrisseyeaaeece2013-11-01 13:56:59 +0000349
Sandrine Bailleux2d3e42d2014-03-21 14:17:51 +0000350# Does the list of goals specified on the command line include a build target?
351ifneq ($(call match_goals,${BUILD_TARGETS}),)
352IS_ANYTHING_TO_BUILD := 1
353endif
James Morrisseyeaaeece2013-11-01 13:56:59 +0000354
Jon Medhurst407a95c2014-02-12 15:54:48 +0000355define MAKE_C
James Morrisseyeaaeece2013-11-01 13:56:59 +0000356
Jon Medhurst407a95c2014-02-12 15:54:48 +0000357$(eval OBJ := $(1)/$(patsubst %.c,%.o,$(notdir $(2))))
358$(eval PREREQUISITES := $(patsubst %.o,%.d,$(OBJ)))
James Morrisseyeaaeece2013-11-01 13:56:59 +0000359
Jon Medhurst407a95c2014-02-12 15:54:48 +0000360$(OBJ) : $(2)
361 @echo " CC $$<"
Soby Mathewbeb83d62014-07-16 15:12:21 +0100362 $$(Q)$$(CC) $$(CFLAGS) -DIMAGE_BL$(3) -c $$< -o $$@
Achin Gupta4f6ad662013-10-25 09:08:21 +0100363
James Morrisseyeaaeece2013-11-01 13:56:59 +0000364
Jon Medhurst407a95c2014-02-12 15:54:48 +0000365$(PREREQUISITES) : $(2)
366 @echo " DEPS $$@"
367 @mkdir -p $(1)
368 $$(Q)$$(CC) $$(CFLAGS) -M -MT $(OBJ) -MF $$@ $$<
James Morrisseyeaaeece2013-11-01 13:56:59 +0000369
Sandrine Bailleux2d3e42d2014-03-21 14:17:51 +0000370ifdef IS_ANYTHING_TO_BUILD
Jon Medhurst407a95c2014-02-12 15:54:48 +0000371-include $(PREREQUISITES)
372endif
Achin Gupta4f6ad662013-10-25 09:08:21 +0100373
Jon Medhurst407a95c2014-02-12 15:54:48 +0000374endef
Achin Gupta4f6ad662013-10-25 09:08:21 +0100375
376
Jon Medhurst407a95c2014-02-12 15:54:48 +0000377define MAKE_S
James Morrisseyeaaeece2013-11-01 13:56:59 +0000378
Jon Medhurst407a95c2014-02-12 15:54:48 +0000379$(eval OBJ := $(1)/$(patsubst %.S,%.o,$(notdir $(2))))
380$(eval PREREQUISITES := $(patsubst %.o,%.d,$(OBJ)))
Achin Gupta4f6ad662013-10-25 09:08:21 +0100381
Jon Medhurst407a95c2014-02-12 15:54:48 +0000382$(OBJ) : $(2)
383 @echo " AS $$<"
Soby Mathewbeb83d62014-07-16 15:12:21 +0100384 $$(Q)$$(AS) $$(ASFLAGS) -DIMAGE_BL$(3) -c $$< -o $$@
James Morrisseyeaaeece2013-11-01 13:56:59 +0000385
Jon Medhurst407a95c2014-02-12 15:54:48 +0000386$(PREREQUISITES) : $(2)
387 @echo " DEPS $$@"
388 @mkdir -p $(1)
389 $$(Q)$$(AS) $$(ASFLAGS) -M -MT $(OBJ) -MF $$@ $$<
Achin Gupta4f6ad662013-10-25 09:08:21 +0100390
Sandrine Bailleux2d3e42d2014-03-21 14:17:51 +0000391ifdef IS_ANYTHING_TO_BUILD
Jon Medhurst407a95c2014-02-12 15:54:48 +0000392-include $(PREREQUISITES)
393endif
Achin Gupta4f6ad662013-10-25 09:08:21 +0100394
Jon Medhurst407a95c2014-02-12 15:54:48 +0000395endef
396
397
398define MAKE_LD
399
400$(eval PREREQUISITES := $(1).d)
401
402$(1) : $(2)
403 @echo " PP $$<"
Juan Castilloe33ee5f2014-12-19 09:51:00 +0000404 $$(Q)$$(AS) $$(ASFLAGS) -P -E -D__LINKER__ -o $$@ $$<
Jon Medhurst407a95c2014-02-12 15:54:48 +0000405
406$(PREREQUISITES) : $(2)
407 @echo " DEPS $$@"
408 @mkdir -p $$(dir $$@)
409 $$(Q)$$(AS) $$(ASFLAGS) -M -MT $(1) -MF $$@ $$<
410
Sandrine Bailleux2d3e42d2014-03-21 14:17:51 +0000411ifdef IS_ANYTHING_TO_BUILD
Jon Medhurst407a95c2014-02-12 15:54:48 +0000412-include $(PREREQUISITES)
413endif
414
415endef
416
417
418define MAKE_OBJS
419 $(eval C_OBJS := $(filter %.c,$(2)))
420 $(eval REMAIN := $(filter-out %.c,$(2)))
Soby Mathewbeb83d62014-07-16 15:12:21 +0100421 $(eval $(foreach obj,$(C_OBJS),$(call MAKE_C,$(1),$(obj),$(3))))
Jon Medhurst407a95c2014-02-12 15:54:48 +0000422
423 $(eval S_OBJS := $(filter %.S,$(REMAIN)))
424 $(eval REMAIN := $(filter-out %.S,$(REMAIN)))
Soby Mathewbeb83d62014-07-16 15:12:21 +0100425 $(eval $(foreach obj,$(S_OBJS),$(call MAKE_S,$(1),$(obj),$(3))))
Jon Medhurst407a95c2014-02-12 15:54:48 +0000426
427 $(and $(REMAIN),$(error Unexpected source files present: $(REMAIN)))
428endef
429
430
431# NOTE: The line continuation '\' is required in the next define otherwise we
432# end up with a line-feed characer at the end of the last c filename.
433# Also bare this issue in mind if extending the list of supported filetypes.
434define SOURCES_TO_OBJS
435 $(notdir $(patsubst %.c,%.o,$(filter %.c,$(1)))) \
436 $(notdir $(patsubst %.S,%.o,$(filter %.S,$(1))))
437endef
438
Juan Castillo11abdcd2014-10-21 11:30:42 +0100439
440# MAKE_TOOL_ARGS macro defines the command line arguments for the FIP and CRT
441# tools at each BL stage. Arguments:
442# $(1) = BL stage (2, 30, 31, 32, 33)
443# $(2) = Binary file
444# $(3) = In FIP (false if empty)
445# $(4) = Create certificates (false if empty)
446# $(5) = Create key certificate (false if empty)
447# $(6) = Private key (optional)
448define MAKE_TOOL_ARGS
449
450$(eval FIP_DEPS += $(if $3,$(2),))
451$(eval FIP_ARGS += $(if $3,--bl$(1) $(2),))
452
453$(eval CRT_DEPS += $(if $4,$(2),))
454$(eval CRT_DEPS += $(if $4,$(if $6,$(6),)))
455$(eval CRT_ARGS += $(if $4,--bl$(1) $(2)))
456$(eval CRT_ARGS += $(if $4,$(if $6,--bl$(1)-key $(6))))
457$(eval CRT_ARGS += $(if $4,--bl$(1)-cert $(BUILD_PLAT)/bl$(1).crt))
458$(eval CRT_ARGS += $(if $4,$(if $5,--bl$(1)-key-cert $(BUILD_PLAT)/bl$(1)_key.crt)))
459
460endef
461
462
463# MAKE_BL macro defines the targets and options to build each BL image.
464# Arguments:
465# $(1) = BL stage (2, 30, 31, 32, 33)
466# $(2) = In FIP (false if empty)
467# $(3) = Create certificates (false if empty)
468# $(4) = Create key certificate (false if empty)
469# $(5) = Private key (optional)
Jon Medhurst407a95c2014-02-12 15:54:48 +0000470define MAKE_BL
471 $(eval BUILD_DIR := ${BUILD_PLAT}/bl$(1))
472 $(eval SOURCES := $(BL$(1)_SOURCES) $(BL_COMMON_SOURCES) $(PLAT_BL_COMMON_SOURCES))
473 $(eval OBJS := $(addprefix $(BUILD_DIR)/,$(call SOURCES_TO_OBJS,$(SOURCES))))
474 $(eval LINKERFILE := $(BUILD_DIR)/bl$(1).ld)
475 $(eval MAPFILE := $(BUILD_DIR)/bl$(1).map)
476 $(eval ELF := $(BUILD_DIR)/bl$(1).elf)
477 $(eval DUMP := $(BUILD_DIR)/bl$(1).dump)
478 $(eval BIN := $(BUILD_PLAT)/bl$(1).bin)
479
Soby Mathewbeb83d62014-07-16 15:12:21 +0100480 $(eval $(call MAKE_OBJS,$(BUILD_DIR),$(SOURCES),$(1)))
Jon Medhurst407a95c2014-02-12 15:54:48 +0000481 $(eval $(call MAKE_LD,$(LINKERFILE),$(BL$(1)_LINKERFILE)))
482
483$(BUILD_DIR) :
484 $$(Q)mkdir -p "$$@"
485
486$(ELF) : $(OBJS) $(LINKERFILE)
487 @echo " LD $$@"
Juan Castillo04be3a52014-06-30 11:41:46 +0100488 @echo 'const char build_message[] = "Built : "__TIME__", "__DATE__; \
489 const char version_string[] = "${VERSION_STRING}";' | \
Jon Medhurstecf0a712014-02-17 12:18:24 +0000490 $$(CC) $$(CFLAGS) -xc - -o $(BUILD_DIR)/build_message.o
Jon Medhurst407a95c2014-02-12 15:54:48 +0000491 $$(Q)$$(LD) -o $$@ $$(LDFLAGS) -Map=$(MAPFILE) --script $(LINKERFILE) \
Jeenu Viswambharan2a30a752014-03-11 11:06:45 +0000492 $(BUILD_DIR)/build_message.o $(OBJS)
Jon Medhurst407a95c2014-02-12 15:54:48 +0000493
494$(DUMP) : $(ELF)
495 @echo " OD $$@"
496 $${Q}$${OD} -dx $$< > $$@
497
498$(BIN) : $(ELF)
499 @echo " BIN $$@"
500 $$(Q)$$(OC) -O binary $$< $$@
501 @echo
502 @echo "Built $$@ successfully"
503 @echo
504
505.PHONY : bl$(1)
506bl$(1) : $(BUILD_DIR) $(BIN) $(DUMP)
507
508all : bl$(1)
509
Juan Castillo11abdcd2014-10-21 11:30:42 +0100510$(eval $(call MAKE_TOOL_ARGS,$(1),$(BIN),$(2),$(3),$(4),$(5)))
Jon Medhurst407a95c2014-02-12 15:54:48 +0000511
512endef
513
514
Jon Medhurst66573cb2014-02-13 15:19:28 +0000515ifeq (${NEED_BL1},yes)
Jon Medhurst407a95c2014-02-12 15:54:48 +0000516$(eval $(call MAKE_BL,1))
Jon Medhurst66573cb2014-02-13 15:19:28 +0000517endif
Jon Medhurst407a95c2014-02-12 15:54:48 +0000518
Jon Medhurst66573cb2014-02-13 15:19:28 +0000519ifeq (${NEED_BL2},yes)
Juan Castillo11abdcd2014-10-21 11:30:42 +0100520$(if ${BL2}, $(eval $(call MAKE_TOOL_ARGS,2,${BL2},in_fip,${CERTS})),\
521 $(eval $(call MAKE_BL,2,in_fip,${CERTS})))
Jon Medhurst66573cb2014-02-13 15:19:28 +0000522endif
Jon Medhurst407a95c2014-02-12 15:54:48 +0000523
Jon Medhurst66573cb2014-02-13 15:19:28 +0000524ifeq (${NEED_BL31},yes)
Jon Medhurst407a95c2014-02-12 15:54:48 +0000525BL31_SOURCES += ${SPD_SOURCES}
Juan Castillo11abdcd2014-10-21 11:30:42 +0100526$(if ${BL31}, $(eval $(call MAKE_TOOL_ARGS,31,${BL31},in_fip,${CERTS},${CERTS},${BL31_KEY})),\
527 $(eval $(call MAKE_BL,31,in_fip,${CERTS},${CERTS},${BL31_KEY})))
Jon Medhurst66573cb2014-02-13 15:19:28 +0000528endif
Jon Medhurst407a95c2014-02-12 15:54:48 +0000529
530ifeq (${NEED_BL32},yes)
Juan Castillo11abdcd2014-10-21 11:30:42 +0100531$(if ${BL32}, $(eval $(call MAKE_TOOL_ARGS,32,${BL32},in_fip,${CERTS},${CERTS},${BL32_KEY})),\
532 $(eval $(call MAKE_BL,32,in_fip,${CERTS},${CERTS},${BL32_KEY})))
Jon Medhurst407a95c2014-02-12 15:54:48 +0000533endif
Ryan Harkin72ee3312014-01-15 16:55:07 +0000534
Sandrine Bailleuxf841ef02014-06-24 14:19:36 +0100535ifeq (${NEED_BL30},yes)
Juan Castillo11abdcd2014-10-21 11:30:42 +0100536$(if ${BL30}, $(eval $(call MAKE_TOOL_ARGS,30,${BL30},in_fip,${CERTS},${CERTS},${BL30_KEY})))
Sandrine Bailleuxf841ef02014-06-24 14:19:36 +0100537
Sandrine Bailleuxf841ef02014-06-24 14:19:36 +0100538# If BL3-0 is needed by the platform then 'BL30' variable must be defined.
539check_bl30:
540 $(if ${BL30},,$(error "To build a FIP for platform ${PLAT}, please set BL30 to point to the SCP firmware"))
541else
Soby Mathewdbee7fc2014-09-08 17:51:01 +0100542
Sandrine Bailleuxf841ef02014-06-24 14:19:36 +0100543# If BL3-0 is not needed by the platform but the user still specified the path
544# to a BL3-0 image then warn him that it will be ignored.
545check_bl30:
546 $(if ${BL30},$(warning "BL3-0 is not supported on platform ${PLAT}, it will just be ignored"),)
547endif
548
Soby Mathewdbee7fc2014-09-08 17:51:01 +0100549ifeq (${NEED_BL33},yes)
Juan Castillo11abdcd2014-10-21 11:30:42 +0100550$(if ${BL33}, $(eval $(call MAKE_TOOL_ARGS,33,${BL33},in_fip,${CERTS},${CERTS},${BL33_KEY})))
Soby Mathewdbee7fc2014-09-08 17:51:01 +0100551
552# If BL3-3 is needed by the platform then 'BL33' variable must be defined.
553check_bl33:
554 $(if ${BL33},,$(error "To build a FIP, please set BL33 to point to the Normal World binary, eg: BL33=../uefi/FVP_AARCH64_EFI.fd"))
555else
556
557# If BL3-3 is not needed by the platform but the user still specified the path
558# to a BL3-3 image then warn him that it will be ignored.
559check_bl33:
560 $(if ${BL33},$(warning "BL3-3 is not supported on platform ${PLAT}, it will just be ignored"),)
561endif
562
Juan Castillo11abdcd2014-10-21 11:30:42 +0100563# Add the dependency on the certificates
564ifneq (${GENERATE_COT},0)
565 all: certificates
566endif
567
568certificates: ${CRT_DEPS} ${CRTTOOL} check_bl30 check_bl33
569 ${Q}${CRTTOOL} ${CRT_ARGS}
570 @echo
571 @echo "Built $@ successfully"
572 @echo "Certificates can be found in ${BUILD_PLAT}"
573 @echo
Soby Mathewdbee7fc2014-09-08 17:51:01 +0100574
Juan Castillo860cc3b2014-11-24 11:45:12 +0000575${BUILD_PLAT}/${FIP_NAME}: ${FIP_DEPS} ${FIPTOOL} check_bl30 check_bl33
Harry Liebelf58ad362014-01-10 18:00:33 +0000576 ${Q}${FIPTOOL} --dump \
Achin Gupta375f5382014-02-18 18:12:48 +0000577 ${FIP_ARGS} \
Harry Liebelf58ad362014-01-10 18:00:33 +0000578 $@
579 @echo
Jeenu Viswambharan2f2cef42014-02-19 09:38:18 +0000580 @echo "Built $@ successfully"
581 @echo
Harry Liebelf58ad362014-01-10 18:00:33 +0000582
583
Joakim Bech35fab8c2014-01-23 14:51:49 +0100584cscope:
585 @echo " CSCOPE"
586 ${Q}find ${CURDIR} -name "*.[chsS]" > cscope.files
587 ${Q}cscope -b -q -k
588
Ryan Harkin72ee3312014-01-15 16:55:07 +0000589help:
Sandrine Bailleuxa08588a2014-03-21 13:16:35 +0000590 @echo "usage: ${MAKE} PLAT=<${HELP_PLATFORMS}> <all|bl1|bl2|bl31|distclean|clean|checkcodebase|checkpatch>"
Ryan Harkin72ee3312014-01-15 16:55:07 +0000591 @echo ""
592 @echo "PLAT is used to specify which platform you wish to build."
Sandrine Bailleuxa08588a2014-03-21 13:16:35 +0000593 @echo "If no platform is specified, PLAT defaults to: ${DEFAULT_PLAT}"
Ryan Harkin72ee3312014-01-15 16:55:07 +0000594 @echo ""
595 @echo "Supported Targets:"
Jeenu Viswambharan8aa559c2014-02-21 11:42:08 +0000596 @echo " all Build the BL1, BL2 and BL31 binaries"
Ian Spray36eaaf32014-01-30 17:25:28 +0000597 @echo " bl1 Build the BL1 binary"
Jeenu Viswambharan8aa559c2014-02-21 11:42:08 +0000598 @echo " bl2 Build the BL2 binary"
Ian Spray36eaaf32014-01-30 17:25:28 +0000599 @echo " bl31 Build the BL31 binary"
600 @echo " checkcodebase Check the coding style of the entire source tree"
601 @echo " checkpatch Check the coding style on changes in the current"
602 @echo " branch against BASE_COMMIT (default origin/master)"
603 @echo " clean Clean the build for the selected platform"
Harry Liebelf58ad362014-01-10 18:00:33 +0000604 @echo " cscope Generate cscope index"
Ian Spray36eaaf32014-01-30 17:25:28 +0000605 @echo " distclean Remove all build artifacts for all platforms"
Juan Castillo11abdcd2014-10-21 11:30:42 +0100606 @echo " certtool Build the Certificate generation tool"
Harry Liebelf58ad362014-01-10 18:00:33 +0000607 @echo " fiptool Build the Firmware Image Package(FIP) creation tool"
Ryan Harkin72ee3312014-01-15 16:55:07 +0000608 @echo ""
609 @echo "note: most build targets require PLAT to be set to a specific platform."
610 @echo ""
611 @echo "example: build all targets for the FVP platform:"
612 @echo " CROSS_COMPILE=aarch64-none-elf- make PLAT=fvp all"