blob: c82c7a20582ab3e486aa58b09758b62d1c5358a2 [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}
Juan Castillo860cc3b2014-11-24 11:45:12 +000066# Default FIP file name
67FIP_NAME := fip.bin
Achin Gupta4f6ad662013-10-25 09:08:21 +010068
Achin Gupta7421b462014-02-01 18:53:26 +000069# Checkpatch ignores
70CHECK_IGNORE = --ignore COMPLEX_MACRO
71
72CHECKPATCH_ARGS = --no-tree --no-signoff ${CHECK_IGNORE}
73CHECKCODE_ARGS = --no-patch --no-tree --no-signoff ${CHECK_IGNORE}
Ian Spray36eaaf32014-01-30 17:25:28 +000074
Jeenu Viswambharan19a0ace2014-05-15 14:40:58 +010075ifeq (${V},0)
Achin Gupta4f6ad662013-10-25 09:08:21 +010076 Q=@
Ian Spray36eaaf32014-01-30 17:25:28 +000077 CHECKCODE_ARGS += --no-summary --terse
Achin Gupta4f6ad662013-10-25 09:08:21 +010078else
79 Q=
80endif
Jeenu Viswambharan2f2cef42014-02-19 09:38:18 +000081export Q
82
James Morrisseyeaaeece2013-11-01 13:56:59 +000083ifneq (${DEBUG}, 0)
84 BUILD_TYPE := debug
Dan Handleycba2c502014-08-08 14:36:42 +010085 # Use LOG_LEVEL_INFO by default for debug builds
86 LOG_LEVEL := 40
James Morrisseyeaaeece2013-11-01 13:56:59 +000087else
88 BUILD_TYPE := release
Dan Handleycba2c502014-08-08 14:36:42 +010089 # Use LOG_LEVEL_NOTICE by default for release builds
90 LOG_LEVEL := 20
James Morrisseyeaaeece2013-11-01 13:56:59 +000091endif
92
Juan Castillo04be3a52014-06-30 11:41:46 +010093# Default build string (git branch and commit)
94ifeq (${BUILD_STRING},)
95 BUILD_STRING := $(shell git log -n 1 --pretty=format:"%h")
96endif
97
98VERSION_STRING := v${VERSION_MAJOR}.${VERSION_MINOR}(${BUILD_TYPE}):${BUILD_STRING}
99
Dan Handley176e7b42014-04-15 18:20:09 +0100100BL_COMMON_SOURCES := common/bl_common.c \
Soby Mathewafe7e2f2014-06-12 17:23:58 +0100101 common/tf_printf.c \
Soby Mathewc1adbbc2014-06-25 10:07:40 +0100102 common/aarch64/debug.S \
Dan Handley176e7b42014-04-15 18:20:09 +0100103 lib/aarch64/cache_helpers.S \
104 lib/aarch64/misc_helpers.S \
Dan Handley176e7b42014-04-15 18:20:09 +0100105 lib/aarch64/xlat_helpers.c \
106 lib/stdlib/std.c \
Dan Handley176e7b42014-04-15 18:20:09 +0100107 plat/common/aarch64/platform_helpers.S
Ryan Harkind7a6b0f2014-01-13 14:40:13 +0000108
Ryan Harkin25cff832014-01-13 12:37:03 +0000109BUILD_BASE := ./build
110BUILD_PLAT := ${BUILD_BASE}/${PLAT}/${BUILD_TYPE}
Achin Gupta4f6ad662013-10-25 09:08:21 +0100111
Ryan Harkin25cff832014-01-13 12:37:03 +0000112PLATFORMS := $(shell ls -I common plat/)
Achin Gupta375f5382014-02-18 18:12:48 +0000113SPDS := $(shell ls -I none services/spd)
Ryan Harkin72ee3312014-01-15 16:55:07 +0000114HELP_PLATFORMS := $(shell echo ${PLATFORMS} | sed 's/ /|/g')
115
Jeenu Viswambharane5c39fd2014-05-16 11:38:10 +0100116# Convenience function for adding build definitions
117# $(eval $(call add_define,FOO)) will have:
118# -DFOO if $(FOO) is empty; -DFOO=$(FOO) otherwise
119define add_define
120DEFINES += -D$(1)$(if $(value $(1)),=$(value $(1)),)
121endef
122
123# Convenience function for verifying option has a boolean value
124# $(eval $(call assert_boolean,FOO)) will assert FOO is 0 or 1
125define assert_boolean
126$(and $(patsubst 0,,$(value $(1))),$(patsubst 1,,$(value $(1))),$(error $(1) must be boolean))
127endef
128
Ryan Harkin25cff832014-01-13 12:37:03 +0000129ifeq (${PLAT},)
130 $(error "Error: Unknown platform. Please use PLAT=<platform name> to specify the platform.")
131endif
Jon Medhurst66573cb2014-02-13 15:19:28 +0000132ifeq ($(findstring ${PLAT},${PLATFORMS}),)
Ryan Harkin25cff832014-01-13 12:37:03 +0000133 $(error "Error: Invalid platform. The following platforms are available: ${PLATFORMS}")
134endif
135
Jon Medhurst66573cb2014-02-13 15:19:28 +0000136all: msg_start
Achin Gupta4f6ad662013-10-25 09:08:21 +0100137
Ryan Harkin25cff832014-01-13 12:37:03 +0000138msg_start:
139 @echo "Building ${PLAT}"
Achin Gupta4f6ad662013-10-25 09:08:21 +0100140
Jon Medhurst66573cb2014-02-13 15:19:28 +0000141include plat/${PLAT}/platform.mk
142
Soby Mathew937488b2014-09-22 14:13:34 +0100143# Include the CPU specific operations makefile. By default all CPU errata
144# workarounds and CPU specifc optimisations are disabled. This can be
Soby Mathew802f8652014-08-14 16:19:29 +0100145# overridden by the platform.
Soby Mathew937488b2014-09-22 14:13:34 +0100146include lib/cpus/cpu-ops.mk
Soby Mathew802f8652014-08-14 16:19:29 +0100147
Jon Medhurst66573cb2014-02-13 15:19:28 +0000148ifdef BL1_SOURCES
149NEED_BL1 := yes
150include bl1/bl1.mk
151endif
152
153ifdef BL2_SOURCES
154NEED_BL2 := yes
155include bl2/bl2.mk
Soby Mathewdbee7fc2014-09-08 17:51:01 +0100156# Using the ARM Trusted Firmware BL2 implies that a BL3-3 image also need to be supplied for the FIP.
157# This flag can be overridden by the platform.
158NEED_BL33 ?= yes
Jon Medhurst66573cb2014-02-13 15:19:28 +0000159endif
Achin Gupta4f6ad662013-10-25 09:08:21 +0100160
Jon Medhurst66573cb2014-02-13 15:19:28 +0000161ifdef BL31_SOURCES
162NEED_BL31 := yes
163include bl31/bl31.mk
Ryan Harkin25cff832014-01-13 12:37:03 +0000164endif
Achin Gupta4f6ad662013-10-25 09:08:21 +0100165
Achin Gupta375f5382014-02-18 18:12:48 +0000166# Include SPD Makefile if one has been specified
167ifneq (${SPD},none)
168 # We expect to locate an spd.mk under the specified SPD directory
169 SPD_MAKE := $(shell m="services/spd/${SPD}/${SPD}.mk"; [ -f "$$m" ] && echo "$$m")
170
171 ifeq (${SPD_MAKE},)
172 $(error Error: No services/spd/${SPD}/${SPD}.mk located)
173 endif
174 $(info Including ${SPD_MAKE})
175 include ${SPD_MAKE}
176
Soby Mathewdbee7fc2014-09-08 17:51:01 +0100177 # If there's BL3-2 companion for the chosen SPD, and the SPD wants to build the
178 # BL3-2 from source, we expect that the SPD's Makefile would set NEED_BL32
179 # variable to "yes". In case the BL3-2 is a binary which needs to be included in
180 # 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 +0000181endif
182
Sandrine Bailleuxa08588a2014-03-21 13:16:35 +0000183.PHONY: all msg_start clean realclean distclean cscope locate-checkpatch checkcodebase checkpatch fiptool fip
James Morrisseyeaaeece2013-11-01 13:56:59 +0000184.SUFFIXES:
185
Sandrine Bailleux47e74a82014-06-23 13:37:53 +0100186INCLUDES += -Iinclude/bl31 \
Dan Handleya70615f2014-04-09 12:48:25 +0100187 -Iinclude/bl31/services \
Dan Handleya70615f2014-04-09 12:48:25 +0100188 -Iinclude/common \
189 -Iinclude/drivers \
190 -Iinclude/drivers/arm \
Dan Handley7b83c442014-08-12 14:20:28 +0100191 -Iinclude/drivers/io \
Dan Handleya70615f2014-04-09 12:48:25 +0100192 -Iinclude/lib \
193 -Iinclude/lib/aarch64 \
Soby Mathew8e2f2872014-08-14 12:49:05 +0100194 -Iinclude/lib/cpus/aarch64 \
Dan Handleyed6ff952014-05-14 17:44:19 +0100195 -Iinclude/plat/common \
Ryan Harkind7a6b0f2014-01-13 14:40:13 +0000196 -Iinclude/stdlib \
197 -Iinclude/stdlib/sys \
Achin Gupta375f5382014-02-18 18:12:48 +0000198 ${PLAT_INCLUDES} \
199 ${SPD_INCLUDES}
Achin Gupta4f6ad662013-10-25 09:08:21 +0100200
Jeenu Viswambharan19a0ace2014-05-15 14:40:58 +0100201# Process DEBUG flag
202$(eval $(call assert_boolean,DEBUG))
203$(eval $(call add_define,DEBUG))
204ifeq (${DEBUG},0)
205 $(eval $(call add_define,NDEBUG))
206else
207CFLAGS += -g
208ASFLAGS += -g -Wa,--gdwarf-2
209endif
210
Jeenu Viswambharand1b60152014-05-12 15:28:47 +0100211# Process NS_TIMER_SWITCH flag
212$(eval $(call assert_boolean,NS_TIMER_SWITCH))
213$(eval $(call add_define,NS_TIMER_SWITCH))
214
Vikram Kanigiri96377452014-04-24 11:02:16 +0100215# Process RESET_TO_BL31 flag
216$(eval $(call assert_boolean,RESET_TO_BL31))
217$(eval $(call add_define,RESET_TO_BL31))
218
Juan Castillo258e94f2014-06-25 17:26:36 +0100219# Process CTX_INCLUDE_FPREGS flag
220$(eval $(call assert_boolean,CTX_INCLUDE_FPREGS))
221$(eval $(call add_define,CTX_INCLUDE_FPREGS))
222
Sandrine Bailleux5fe57c12014-07-17 17:23:14 +0100223# Process ARM_GIC_ARCH flag
224$(eval $(call add_define,ARM_GIC_ARCH))
225
Soby Mathew041f62a2014-07-14 16:58:03 +0100226# Process ASM_ASSERTION flag
227$(eval $(call assert_boolean,ASM_ASSERTION))
228$(eval $(call add_define,ASM_ASSERTION))
Sandrine Bailleux5fe57c12014-07-17 17:23:14 +0100229
Dan Handleycba2c502014-08-08 14:36:42 +0100230# Process LOG_LEVEL flag
231$(eval $(call add_define,LOG_LEVEL))
232
Harry Liebel0af6d642013-12-20 18:51:12 +0000233ASFLAGS += -nostdinc -ffreestanding -Wa,--fatal-warnings \
Sandrine Bailleux47e74a82014-06-23 13:37:53 +0100234 -Werror -Wmissing-include-dirs \
Jeenu Viswambharan19a0ace2014-05-15 14:40:58 +0100235 -mgeneral-regs-only -D__ASSEMBLY__ \
236 ${DEFINES} ${INCLUDES}
237CFLAGS += -nostdinc -pedantic -ffreestanding -Wall \
Sandrine Bailleux47e74a82014-06-23 13:37:53 +0100238 -Werror -Wmissing-include-dirs \
239 -mgeneral-regs-only -std=c99 -c -Os \
Jeenu Viswambharan19a0ace2014-05-15 14:40:58 +0100240 ${DEFINES} ${INCLUDES}
Andrew Thoelkee01ea342014-03-18 07:13:52 +0000241CFLAGS += -ffunction-sections -fdata-sections
Achin Gupta4f6ad662013-10-25 09:08:21 +0100242
Sandrine Bailleux3e850a82013-11-20 11:50:48 +0000243LDFLAGS += --fatal-warnings -O1
Andrew Thoelkee01ea342014-03-18 07:13:52 +0000244LDFLAGS += --gc-sections
Achin Gupta4f6ad662013-10-25 09:08:21 +0100245
246
James Morrisseyeaaeece2013-11-01 13:56:59 +0000247CC := ${CROSS_COMPILE}gcc
248CPP := ${CROSS_COMPILE}cpp
249AS := ${CROSS_COMPILE}gcc
250AR := ${CROSS_COMPILE}ar
251LD := ${CROSS_COMPILE}ld
252OC := ${CROSS_COMPILE}objcopy
253OD := ${CROSS_COMPILE}objdump
254NM := ${CROSS_COMPILE}nm
255PP := ${CROSS_COMPILE}gcc -E ${CFLAGS}
Achin Gupta4f6ad662013-10-25 09:08:21 +0100256
Harry Liebelf58ad362014-01-10 18:00:33 +0000257# Variables for use with Firmware Image Package
258FIPTOOLPATH ?= tools/fip_create
Achin Gupta375f5382014-02-18 18:12:48 +0000259FIPTOOL ?= ${FIPTOOLPATH}/fip_create
Harry Liebelf58ad362014-01-10 18:00:33 +0000260fiptool: ${FIPTOOL}
Juan Castillo860cc3b2014-11-24 11:45:12 +0000261fip: ${BUILD_PLAT}/${FIP_NAME}
Harry Liebelf58ad362014-01-10 18:00:33 +0000262
Ian Spray36eaaf32014-01-30 17:25:28 +0000263locate-checkpatch:
264ifndef CHECKPATCH
265 $(error "Please set CHECKPATCH to point to the Linux checkpatch.pl file, eg: CHECKPATCH=../linux/script/checkpatch.pl")
266else
267ifeq (,$(wildcard ${CHECKPATCH}))
268 $(error "The file CHECKPATCH points to cannot be found, use eg: CHECKPATCH=../linux/script/checkpatch.pl")
269endif
270endif
271
Achin Gupta4f6ad662013-10-25 09:08:21 +0100272clean:
273 @echo " CLEAN"
Ryan Harkin25cff832014-01-13 12:37:03 +0000274 ${Q}rm -rf ${BUILD_PLAT}
Jeenu Viswambharan2f2cef42014-02-19 09:38:18 +0000275 ${Q}${MAKE} --no-print-directory -C ${FIPTOOLPATH} clean
Achin Gupta4f6ad662013-10-25 09:08:21 +0100276
James Morrisseyeaaeece2013-11-01 13:56:59 +0000277realclean distclean:
278 @echo " REALCLEAN"
279 ${Q}rm -rf ${BUILD_BASE}
Joakim Bech35fab8c2014-01-23 14:51:49 +0100280 ${Q}rm -f ${CURDIR}/cscope.*
Jeenu Viswambharan2f2cef42014-02-19 09:38:18 +0000281 ${Q}${MAKE} --no-print-directory -C ${FIPTOOLPATH} clean
Achin Gupta4f6ad662013-10-25 09:08:21 +0100282
Ian Spray36eaaf32014-01-30 17:25:28 +0000283checkcodebase: locate-checkpatch
284 @echo " CHECKING STYLE"
285 @if test -d .git ; then \
Juan Castillo2d552402014-06-13 17:05:10 +0100286 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 +0000287 else \
Juan Castillo2d552402014-06-13 17:05:10 +0100288 find . -type f -not -iwholename "*.git*" -not -iwholename "*build*" -not -iwholename "*stdlib*" -exec ${CHECKPATCH} ${CHECKCODE_ARGS} -f {} \; ; \
Ian Spray36eaaf32014-01-30 17:25:28 +0000289 fi
290
291checkpatch: locate-checkpatch
292 @echo " CHECKING STYLE"
293 @git format-patch --stdout ${BASE_COMMIT} | ${CHECKPATCH} ${CHECKPATCH_ARGS} - || true
294
Sandrine Bailleux152c17f2014-10-27 17:10:46 +0000295.PHONY: ${FIPTOOL}
Harry Liebelf58ad362014-01-10 18:00:33 +0000296${FIPTOOL}:
Jeenu Viswambharan2f2cef42014-02-19 09:38:18 +0000297 ${Q}${MAKE} --no-print-directory -C ${FIPTOOLPATH}
Harry Liebelf58ad362014-01-10 18:00:33 +0000298
Jon Medhurst407a95c2014-02-12 15:54:48 +0000299define match_goals
300$(strip $(foreach goal,$(1),$(filter $(goal),$(MAKECMDGOALS))))
301endef
Achin Gupta4f6ad662013-10-25 09:08:21 +0100302
Sandrine Bailleux2d3e42d2014-03-21 14:17:51 +0000303# List of rules that involve building things
304BUILD_TARGETS := all bl1 bl2 bl31 bl32 fip
James Morrisseyeaaeece2013-11-01 13:56:59 +0000305
Sandrine Bailleux2d3e42d2014-03-21 14:17:51 +0000306# Does the list of goals specified on the command line include a build target?
307ifneq ($(call match_goals,${BUILD_TARGETS}),)
308IS_ANYTHING_TO_BUILD := 1
309endif
James Morrisseyeaaeece2013-11-01 13:56:59 +0000310
Jon Medhurst407a95c2014-02-12 15:54:48 +0000311define MAKE_C
James Morrisseyeaaeece2013-11-01 13:56:59 +0000312
Jon Medhurst407a95c2014-02-12 15:54:48 +0000313$(eval OBJ := $(1)/$(patsubst %.c,%.o,$(notdir $(2))))
314$(eval PREREQUISITES := $(patsubst %.o,%.d,$(OBJ)))
James Morrisseyeaaeece2013-11-01 13:56:59 +0000315
Jon Medhurst407a95c2014-02-12 15:54:48 +0000316$(OBJ) : $(2)
317 @echo " CC $$<"
Soby Mathewbeb83d62014-07-16 15:12:21 +0100318 $$(Q)$$(CC) $$(CFLAGS) -DIMAGE_BL$(3) -c $$< -o $$@
Achin Gupta4f6ad662013-10-25 09:08:21 +0100319
James Morrisseyeaaeece2013-11-01 13:56:59 +0000320
Jon Medhurst407a95c2014-02-12 15:54:48 +0000321$(PREREQUISITES) : $(2)
322 @echo " DEPS $$@"
323 @mkdir -p $(1)
324 $$(Q)$$(CC) $$(CFLAGS) -M -MT $(OBJ) -MF $$@ $$<
James Morrisseyeaaeece2013-11-01 13:56:59 +0000325
Sandrine Bailleux2d3e42d2014-03-21 14:17:51 +0000326ifdef IS_ANYTHING_TO_BUILD
Jon Medhurst407a95c2014-02-12 15:54:48 +0000327-include $(PREREQUISITES)
328endif
Achin Gupta4f6ad662013-10-25 09:08:21 +0100329
Jon Medhurst407a95c2014-02-12 15:54:48 +0000330endef
Achin Gupta4f6ad662013-10-25 09:08:21 +0100331
332
Jon Medhurst407a95c2014-02-12 15:54:48 +0000333define MAKE_S
James Morrisseyeaaeece2013-11-01 13:56:59 +0000334
Jon Medhurst407a95c2014-02-12 15:54:48 +0000335$(eval OBJ := $(1)/$(patsubst %.S,%.o,$(notdir $(2))))
336$(eval PREREQUISITES := $(patsubst %.o,%.d,$(OBJ)))
Achin Gupta4f6ad662013-10-25 09:08:21 +0100337
Jon Medhurst407a95c2014-02-12 15:54:48 +0000338$(OBJ) : $(2)
339 @echo " AS $$<"
Soby Mathewbeb83d62014-07-16 15:12:21 +0100340 $$(Q)$$(AS) $$(ASFLAGS) -DIMAGE_BL$(3) -c $$< -o $$@
James Morrisseyeaaeece2013-11-01 13:56:59 +0000341
Jon Medhurst407a95c2014-02-12 15:54:48 +0000342$(PREREQUISITES) : $(2)
343 @echo " DEPS $$@"
344 @mkdir -p $(1)
345 $$(Q)$$(AS) $$(ASFLAGS) -M -MT $(OBJ) -MF $$@ $$<
Achin Gupta4f6ad662013-10-25 09:08:21 +0100346
Sandrine Bailleux2d3e42d2014-03-21 14:17:51 +0000347ifdef IS_ANYTHING_TO_BUILD
Jon Medhurst407a95c2014-02-12 15:54:48 +0000348-include $(PREREQUISITES)
349endif
Achin Gupta4f6ad662013-10-25 09:08:21 +0100350
Jon Medhurst407a95c2014-02-12 15:54:48 +0000351endef
352
353
354define MAKE_LD
355
356$(eval PREREQUISITES := $(1).d)
357
358$(1) : $(2)
359 @echo " PP $$<"
360 $$(Q)$$(AS) $$(ASFLAGS) -P -E -o $$@ $$<
361
362$(PREREQUISITES) : $(2)
363 @echo " DEPS $$@"
364 @mkdir -p $$(dir $$@)
365 $$(Q)$$(AS) $$(ASFLAGS) -M -MT $(1) -MF $$@ $$<
366
Sandrine Bailleux2d3e42d2014-03-21 14:17:51 +0000367ifdef IS_ANYTHING_TO_BUILD
Jon Medhurst407a95c2014-02-12 15:54:48 +0000368-include $(PREREQUISITES)
369endif
370
371endef
372
373
374define MAKE_OBJS
375 $(eval C_OBJS := $(filter %.c,$(2)))
376 $(eval REMAIN := $(filter-out %.c,$(2)))
Soby Mathewbeb83d62014-07-16 15:12:21 +0100377 $(eval $(foreach obj,$(C_OBJS),$(call MAKE_C,$(1),$(obj),$(3))))
Jon Medhurst407a95c2014-02-12 15:54:48 +0000378
379 $(eval S_OBJS := $(filter %.S,$(REMAIN)))
380 $(eval REMAIN := $(filter-out %.S,$(REMAIN)))
Soby Mathewbeb83d62014-07-16 15:12:21 +0100381 $(eval $(foreach obj,$(S_OBJS),$(call MAKE_S,$(1),$(obj),$(3))))
Jon Medhurst407a95c2014-02-12 15:54:48 +0000382
383 $(and $(REMAIN),$(error Unexpected source files present: $(REMAIN)))
384endef
385
386
387# NOTE: The line continuation '\' is required in the next define otherwise we
388# end up with a line-feed characer at the end of the last c filename.
389# Also bare this issue in mind if extending the list of supported filetypes.
390define SOURCES_TO_OBJS
391 $(notdir $(patsubst %.c,%.o,$(filter %.c,$(1)))) \
392 $(notdir $(patsubst %.S,%.o,$(filter %.S,$(1))))
393endef
394
395define MAKE_BL
396 $(eval BUILD_DIR := ${BUILD_PLAT}/bl$(1))
397 $(eval SOURCES := $(BL$(1)_SOURCES) $(BL_COMMON_SOURCES) $(PLAT_BL_COMMON_SOURCES))
398 $(eval OBJS := $(addprefix $(BUILD_DIR)/,$(call SOURCES_TO_OBJS,$(SOURCES))))
399 $(eval LINKERFILE := $(BUILD_DIR)/bl$(1).ld)
400 $(eval MAPFILE := $(BUILD_DIR)/bl$(1).map)
401 $(eval ELF := $(BUILD_DIR)/bl$(1).elf)
402 $(eval DUMP := $(BUILD_DIR)/bl$(1).dump)
403 $(eval BIN := $(BUILD_PLAT)/bl$(1).bin)
404
Soby Mathewbeb83d62014-07-16 15:12:21 +0100405 $(eval $(call MAKE_OBJS,$(BUILD_DIR),$(SOURCES),$(1)))
Jon Medhurst407a95c2014-02-12 15:54:48 +0000406 $(eval $(call MAKE_LD,$(LINKERFILE),$(BL$(1)_LINKERFILE)))
407
408$(BUILD_DIR) :
409 $$(Q)mkdir -p "$$@"
410
411$(ELF) : $(OBJS) $(LINKERFILE)
412 @echo " LD $$@"
Juan Castillo04be3a52014-06-30 11:41:46 +0100413 @echo 'const char build_message[] = "Built : "__TIME__", "__DATE__; \
414 const char version_string[] = "${VERSION_STRING}";' | \
Jon Medhurstecf0a712014-02-17 12:18:24 +0000415 $$(CC) $$(CFLAGS) -xc - -o $(BUILD_DIR)/build_message.o
Jon Medhurst407a95c2014-02-12 15:54:48 +0000416 $$(Q)$$(LD) -o $$@ $$(LDFLAGS) -Map=$(MAPFILE) --script $(LINKERFILE) \
Jeenu Viswambharan2a30a752014-03-11 11:06:45 +0000417 $(BUILD_DIR)/build_message.o $(OBJS)
Jon Medhurst407a95c2014-02-12 15:54:48 +0000418
419$(DUMP) : $(ELF)
420 @echo " OD $$@"
421 $${Q}$${OD} -dx $$< > $$@
422
423$(BIN) : $(ELF)
424 @echo " BIN $$@"
425 $$(Q)$$(OC) -O binary $$< $$@
426 @echo
427 @echo "Built $$@ successfully"
428 @echo
429
430.PHONY : bl$(1)
431bl$(1) : $(BUILD_DIR) $(BIN) $(DUMP)
432
433all : bl$(1)
434
435$(eval FIP_DEPS += $(if $2,$(BIN),))
436$(eval FIP_ARGS += $(if $2,--bl$(1) $(BIN),))
437
438endef
439
440
Jon Medhurst66573cb2014-02-13 15:19:28 +0000441ifeq (${NEED_BL1},yes)
Jon Medhurst407a95c2014-02-12 15:54:48 +0000442$(eval $(call MAKE_BL,1))
Jon Medhurst66573cb2014-02-13 15:19:28 +0000443endif
Jon Medhurst407a95c2014-02-12 15:54:48 +0000444
Jon Medhurst66573cb2014-02-13 15:19:28 +0000445ifeq (${NEED_BL2},yes)
Soby Mathewdbee7fc2014-09-08 17:51:01 +0100446$(if ${BL2}, $(eval FIP_DEPS += ${BL2}) $(eval FIP_ARGS += --bl2 ${BL2}),\
447 $(eval $(call MAKE_BL,2,in_fip)))
Jon Medhurst66573cb2014-02-13 15:19:28 +0000448endif
Jon Medhurst407a95c2014-02-12 15:54:48 +0000449
Jon Medhurst66573cb2014-02-13 15:19:28 +0000450ifeq (${NEED_BL31},yes)
Jon Medhurst407a95c2014-02-12 15:54:48 +0000451BL31_SOURCES += ${SPD_SOURCES}
Soby Mathewdbee7fc2014-09-08 17:51:01 +0100452$(if ${BL31}, $(eval FIP_DEPS += ${BL31}) $(eval FIP_ARGS += --bl31 ${BL31}),\
453 $(eval $(call MAKE_BL,31,in_fip)))
Jon Medhurst66573cb2014-02-13 15:19:28 +0000454endif
Jon Medhurst407a95c2014-02-12 15:54:48 +0000455
456ifeq (${NEED_BL32},yes)
Soby Mathewdbee7fc2014-09-08 17:51:01 +0100457$(if ${BL32}, $(eval FIP_DEPS += ${BL32}) $(eval FIP_ARGS += --bl32 ${BL32}),\
458 $(eval $(call MAKE_BL,32,in_fip)))
Jon Medhurst407a95c2014-02-12 15:54:48 +0000459endif
Ryan Harkin72ee3312014-01-15 16:55:07 +0000460
Sandrine Bailleuxf841ef02014-06-24 14:19:36 +0100461ifeq (${NEED_BL30},yes)
Soby Mathewdbee7fc2014-09-08 17:51:01 +0100462$(if ${BL30}, $(eval FIP_DEPS += ${BL30}) $(eval FIP_ARGS += --bl30 ${BL30}), )
Sandrine Bailleuxf841ef02014-06-24 14:19:36 +0100463
Sandrine Bailleuxf841ef02014-06-24 14:19:36 +0100464# If BL3-0 is needed by the platform then 'BL30' variable must be defined.
465check_bl30:
466 $(if ${BL30},,$(error "To build a FIP for platform ${PLAT}, please set BL30 to point to the SCP firmware"))
467else
Soby Mathewdbee7fc2014-09-08 17:51:01 +0100468
Sandrine Bailleuxf841ef02014-06-24 14:19:36 +0100469# If BL3-0 is not needed by the platform but the user still specified the path
470# to a BL3-0 image then warn him that it will be ignored.
471check_bl30:
472 $(if ${BL30},$(warning "BL3-0 is not supported on platform ${PLAT}, it will just be ignored"),)
473endif
474
Soby Mathewdbee7fc2014-09-08 17:51:01 +0100475ifeq (${NEED_BL33},yes)
476$(if ${BL33}, $(eval FIP_DEPS += ${BL33}) $(eval FIP_ARGS += --bl33 ${BL33}), )
477
478# If BL3-3 is needed by the platform then 'BL33' variable must be defined.
479check_bl33:
480 $(if ${BL33},,$(error "To build a FIP, please set BL33 to point to the Normal World binary, eg: BL33=../uefi/FVP_AARCH64_EFI.fd"))
481else
482
483# If BL3-3 is not needed by the platform but the user still specified the path
484# to a BL3-3 image then warn him that it will be ignored.
485check_bl33:
486 $(if ${BL33},$(warning "BL3-3 is not supported on platform ${PLAT}, it will just be ignored"),)
487endif
488
489
Juan Castillo860cc3b2014-11-24 11:45:12 +0000490${BUILD_PLAT}/${FIP_NAME}: ${FIP_DEPS} ${FIPTOOL} check_bl30 check_bl33
Harry Liebelf58ad362014-01-10 18:00:33 +0000491 ${Q}${FIPTOOL} --dump \
Achin Gupta375f5382014-02-18 18:12:48 +0000492 ${FIP_ARGS} \
Harry Liebelf58ad362014-01-10 18:00:33 +0000493 $@
494 @echo
Jeenu Viswambharan2f2cef42014-02-19 09:38:18 +0000495 @echo "Built $@ successfully"
496 @echo
Harry Liebelf58ad362014-01-10 18:00:33 +0000497
498
Joakim Bech35fab8c2014-01-23 14:51:49 +0100499cscope:
500 @echo " CSCOPE"
501 ${Q}find ${CURDIR} -name "*.[chsS]" > cscope.files
502 ${Q}cscope -b -q -k
503
Ryan Harkin72ee3312014-01-15 16:55:07 +0000504help:
Sandrine Bailleuxa08588a2014-03-21 13:16:35 +0000505 @echo "usage: ${MAKE} PLAT=<${HELP_PLATFORMS}> <all|bl1|bl2|bl31|distclean|clean|checkcodebase|checkpatch>"
Ryan Harkin72ee3312014-01-15 16:55:07 +0000506 @echo ""
507 @echo "PLAT is used to specify which platform you wish to build."
Sandrine Bailleuxa08588a2014-03-21 13:16:35 +0000508 @echo "If no platform is specified, PLAT defaults to: ${DEFAULT_PLAT}"
Ryan Harkin72ee3312014-01-15 16:55:07 +0000509 @echo ""
510 @echo "Supported Targets:"
Jeenu Viswambharan8aa559c2014-02-21 11:42:08 +0000511 @echo " all Build the BL1, BL2 and BL31 binaries"
Ian Spray36eaaf32014-01-30 17:25:28 +0000512 @echo " bl1 Build the BL1 binary"
Jeenu Viswambharan8aa559c2014-02-21 11:42:08 +0000513 @echo " bl2 Build the BL2 binary"
Ian Spray36eaaf32014-01-30 17:25:28 +0000514 @echo " bl31 Build the BL31 binary"
515 @echo " checkcodebase Check the coding style of the entire source tree"
516 @echo " checkpatch Check the coding style on changes in the current"
517 @echo " branch against BASE_COMMIT (default origin/master)"
518 @echo " clean Clean the build for the selected platform"
Harry Liebelf58ad362014-01-10 18:00:33 +0000519 @echo " cscope Generate cscope index"
Ian Spray36eaaf32014-01-30 17:25:28 +0000520 @echo " distclean Remove all build artifacts for all platforms"
Harry Liebelf58ad362014-01-10 18:00:33 +0000521 @echo " fiptool Build the Firmware Image Package(FIP) creation tool"
Ryan Harkin72ee3312014-01-15 16:55:07 +0000522 @echo ""
523 @echo "note: most build targets require PLAT to be set to a specific platform."
524 @echo ""
525 @echo "example: build all targets for the FVP platform:"
526 @echo " CROSS_COMPILE=aarch64-none-elf- make PLAT=fvp all"