Makefile 20.9 KB
Newer Older
1
#
2
# Copyright (c) 2013-2015, ARM Limited and Contributors. All rights reserved.
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions are met:
#
# Redistributions of source code must retain the above copyright notice, this
# list of conditions and the following disclaimer.
#
# Redistributions in binary form must reproduce the above copyright notice,
# this list of conditions and the following disclaimer in the documentation
# and/or other materials provided with the distribution.
#
# Neither the name of ARM nor the names of its contributors may be used
# to endorse or promote products derived from this software without specific
# prior written permission.
#
# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
# POSSIBILITY OF SUCH DAMAGE.
#

31
32
33
#
# Trusted Firmware Version
#
Juan Castillo's avatar
Juan Castillo committed
34
VERSION_MAJOR			:= 1
35
VERSION_MINOR			:= 2
36

37
38
39
# Default goal is build all images
.DEFAULT_GOAL			:= all

Juan Castillo's avatar
Juan Castillo committed
40
41
42
include make_helpers/build_macros.mk

################################################################################
Jeenu Viswambharan's avatar
Jeenu Viswambharan committed
43
# Default values for build configurations
Juan Castillo's avatar
Juan Castillo committed
44
################################################################################
Jeenu Viswambharan's avatar
Jeenu Viswambharan committed
45
46

# Build verbosity
Juan Castillo's avatar
Juan Castillo committed
47
V				:= 0
Jeenu Viswambharan's avatar
Jeenu Viswambharan committed
48
# Debug build
Juan Castillo's avatar
Juan Castillo committed
49
DEBUG				:= 0
Jeenu Viswambharan's avatar
Jeenu Viswambharan committed
50
# Build platform
Juan Castillo's avatar
Juan Castillo committed
51
52
DEFAULT_PLAT			:= fvp
PLAT				:= ${DEFAULT_PLAT}
Jeenu Viswambharan's avatar
Jeenu Viswambharan committed
53
# SPD choice
Juan Castillo's avatar
Juan Castillo committed
54
SPD				:= none
Jeenu Viswambharan's avatar
Jeenu Viswambharan committed
55
# Base commit to perform code check on
Juan Castillo's avatar
Juan Castillo committed
56
BASE_COMMIT			:= origin/master
57
# NS timer register save and restore
Juan Castillo's avatar
Juan Castillo committed
58
NS_TIMER_SWITCH			:= 0
59
# By default, BL1 acts as the reset handler, not BL31
Juan Castillo's avatar
Juan Castillo committed
60
RESET_TO_BL31			:= 0
61
62
# Include FP registers in cpu context
CTX_INCLUDE_FPREGS		:= 0
63
64
# Determine the version of ARM GIC architecture to use for interrupt management
# in EL3. The platform port can change this value if needed.
Juan Castillo's avatar
Juan Castillo committed
65
ARM_GIC_ARCH			:= 2
66
67
# Determine the version of ARM CCI product used in the platform. The platform
# port can change this value if needed.
Juan Castillo's avatar
Juan Castillo committed
68
ARM_CCI_PRODUCT_ID		:= 400
69
70
# Flag used to indicate if ASM_ASSERTION should be enabled for the build.
# This defaults to being present in DEBUG builds only.
Juan Castillo's avatar
Juan Castillo committed
71
ASM_ASSERTION			:= ${DEBUG}
72
# Build option to choose whether Trusted firmware uses Coherent memory or not.
Juan Castillo's avatar
Juan Castillo committed
73
USE_COHERENT_MEM		:= 1
74
75
# Flag used to choose the power state format viz Extended State-ID or the Original
# format.
Juan Castillo's avatar
Juan Castillo committed
76
PSCI_EXTENDED_STATE_ID		:= 0
77
# Default FIP file name
Juan Castillo's avatar
Juan Castillo committed
78
FIP_NAME			:= fip.bin
79
80
# Default FWU_FIP file name
FWU_FIP_NAME			:= fwu_fip.bin
81
# By default, use the -pedantic option in the gcc command line
Juan Castillo's avatar
Juan Castillo committed
82
DISABLE_PEDANTIC		:= 0
83
# Flags to generate the Chain of Trust
Juan Castillo's avatar
Juan Castillo committed
84
85
86
GENERATE_COT			:= 0
CREATE_KEYS			:= 1
SAVE_KEYS			:= 0
87
# Flags to build TF with Trusted Boot support
Juan Castillo's avatar
Juan Castillo committed
88
TRUSTED_BOARD_BOOT		:= 0
89
90
91
# By default, consider that the platform's reset address is not programmable.
# The platform Makefile is free to override this value.
PROGRAMMABLE_RESET_ADDRESS	:= 0
92
93
# Build flag to treat usage of deprecated platform and framework APIs as error.
ERROR_DEPRECATED		:= 0
94
95
96
# By default, consider that the platform may release several CPUs out of reset.
# The platform Makefile is free to override this value.
COLD_BOOT_SINGLE_CPU		:= 0
97
98
99
# Flag to introduce an infinite loop in BL1 just before it exits into the next
# image. This is meant to help debugging the post-BL2 phase.
SPIN_ON_BL1_EXIT		:= 0
100
101
# Build PL011 UART driver in minimal generic UART mode
PL011_GENERIC_UART		:= 0
Juan Castillo's avatar
Juan Castillo committed
102
103
104
105
106


################################################################################
# Checkpatch script options
################################################################################
107

Juan Castillo's avatar
Juan Castillo committed
108
CHECK_IGNORE		:=	--ignore COMPLEX_MACRO \
109
110
				--ignore GERRIT_CHANGE_ID \
				--ignore GIT_COMMIT_ID
Juan Castillo's avatar
Juan Castillo committed
111
112
CHECKPATCH_ARGS		:=	--no-tree --no-signoff ${CHECK_IGNORE}
CHECKCODE_ARGS		:=	--no-patch --no-tree --no-signoff ${CHECK_IGNORE}
113
# Do not check the coding style on C library files
Juan Castillo's avatar
Juan Castillo committed
114
CHECK_PATHS		:=	$(shell ls -I include -I lib) \
115
116
				$(addprefix include/,$(shell ls -I stdlib include)) \
				$(addprefix lib/,$(shell ls -I stdlib lib))
117

Juan Castillo's avatar
Juan Castillo committed
118
119
120
121
122
123

################################################################################
# Process build options
################################################################################

# Verbose flag
Jeenu Viswambharan's avatar
Jeenu Viswambharan committed
124
ifeq (${V},0)
Juan Castillo's avatar
Juan Castillo committed
125
126
        Q=@
        CHECKCODE_ARGS	+=	--no-summary --terse
127
else
Juan Castillo's avatar
Juan Castillo committed
128
        Q=
129
endif
130
131
export Q

Juan Castillo's avatar
Juan Castillo committed
132
133
# Process Debug flag
$(eval $(call add_define,DEBUG))
134
ifneq (${DEBUG}, 0)
Juan Castillo's avatar
Juan Castillo committed
135
136
137
138
139
        BUILD_TYPE	:=	debug
        CFLAGS		+= 	-g
        ASFLAGS		+= 	-g -Wa,--gdwarf-2
        # Use LOG_LEVEL_INFO by default for debug builds
        LOG_LEVEL	:=	40
140
else
Juan Castillo's avatar
Juan Castillo committed
141
142
143
144
        BUILD_TYPE	:=	release
        $(eval $(call add_define,NDEBUG))
        # Use LOG_LEVEL_NOTICE by default for release builds
        LOG_LEVEL	:=	20
145
146
endif

147
148
# Default build string (git branch and commit)
ifeq (${BUILD_STRING},)
Juan Castillo's avatar
Juan Castillo committed
149
        BUILD_STRING	:=	$(shell git log -n 1 --pretty=format:"%h")
150
151
152
endif
VERSION_STRING		:=	v${VERSION_MAJOR}.${VERSION_MINOR}(${BUILD_TYPE}):${BUILD_STRING}

Juan Castillo's avatar
Juan Castillo committed
153
154
155
156
# The cert_create tool cannot generate certificates individually, so we use the
# target 'certificates' to create them all
ifneq (${GENERATE_COT},0)
        FIP_DEPS += certificates
157
        FWU_FIP_DEPS += fwu_certificates
Juan Castillo's avatar
Juan Castillo committed
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
endif


################################################################################
# Toolchain
################################################################################

CC			:=	${CROSS_COMPILE}gcc
CPP			:=	${CROSS_COMPILE}cpp
AS			:=	${CROSS_COMPILE}gcc
AR			:=	${CROSS_COMPILE}ar
LD			:=	${CROSS_COMPILE}ld
OC			:=	${CROSS_COMPILE}objcopy
OD			:=	${CROSS_COMPILE}objdump
NM			:=	${CROSS_COMPILE}nm
PP			:=	${CROSS_COMPILE}gcc -E

ASFLAGS			+= 	-nostdinc -ffreestanding -Wa,--fatal-warnings	\
				-Werror -Wmissing-include-dirs			\
				-mgeneral-regs-only -D__ASSEMBLY__		\
				${DEFINES} ${INCLUDES}
CFLAGS			+= 	-nostdinc -ffreestanding -Wall			\
				-Werror -Wmissing-include-dirs			\
181
182
				-mgeneral-regs-only -mstrict-align		\
				-std=c99 -c -Os					\
Juan Castillo's avatar
Juan Castillo committed
183
184
185
186
187
188
189
190
191
192
193
194
				${DEFINES} ${INCLUDES}
CFLAGS			+=	-ffunction-sections -fdata-sections

LDFLAGS			+=	--fatal-warnings -O1
LDFLAGS			+=	--gc-sections


################################################################################
# Common sources and include directories
################################################################################

BL_COMMON_SOURCES	+=	common/bl_common.c			\
195
				common/tf_printf.c			\
196
				common/aarch64/debug.S			\
Dan Handley's avatar
Dan Handley committed
197
198
199
200
201
				lib/aarch64/cache_helpers.S		\
				lib/aarch64/misc_helpers.S		\
				lib/aarch64/xlat_helpers.c		\
				lib/stdlib/std.c			\
				plat/common/aarch64/platform_helpers.S
202

203
204
INCLUDES		+=	-Iinclude/bl1			\
				-Iinclude/bl31			\
Juan Castillo's avatar
Juan Castillo committed
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
				-Iinclude/bl31/services		\
				-Iinclude/common		\
				-Iinclude/drivers		\
				-Iinclude/drivers/arm		\
				-Iinclude/drivers/auth		\
				-Iinclude/drivers/io		\
				-Iinclude/drivers/ti/uart	\
				-Iinclude/lib			\
				-Iinclude/lib/aarch64		\
				-Iinclude/lib/cpus/aarch64	\
				-Iinclude/plat/common		\
				-Iinclude/stdlib		\
				-Iinclude/stdlib/sys		\
				${PLAT_INCLUDES}		\
				${SPD_INCLUDES}


################################################################################
# Generic definitions
################################################################################

226
227
228
BUILD_BASE		:=	./build
BUILD_PLAT		:=	${BUILD_BASE}/${PLAT}/${BUILD_TYPE}

229
230
231
232
233
234
235
PLAT_MAKEFILE		:=	platform.mk
# Generate the platforms list by recursively searching for all directories
# under /plat containing a PLAT_MAKEFILE. Append each platform with a `|`
# char and strip out the final '|'.
PLATFORMS		:=	$(shell find plat/ -name '${PLAT_MAKEFILE}' -print0 |			\
					sed -r 's%[^\x00]*\/([^/]*)\/${PLAT_MAKEFILE}\x00%\1|%g' |	\
					sed -r 's/\|$$//')
236
SPDS			:=	$(shell ls -I none services/spd)
237

Juan Castillo's avatar
Juan Castillo committed
238
239
240
241
242
243
244
245
246
# Platforms providing their own TBB makefile may override this value
INCLUDE_TBBR_MK		:=	1


################################################################################
# Include SPD Makefile if one has been specified
################################################################################

ifneq (${SPD},none)
247
248
249
250
ifdef EL3_PAYLOAD_BASE
        $(warning "SPD and EL3_PAYLOAD_BASE are incompatible build options.")
        $(warning "The SPD and its BL32 companion will be present but ignored.")
endif
Juan Castillo's avatar
Juan Castillo committed
251
252
253
254
255
256
257
258
259
        # We expect to locate an spd.mk under the specified SPD directory
        SPD_MAKE	:=	$(shell m="services/spd/${SPD}/${SPD}.mk"; [ -f "$$m" ] && echo "$$m")

        ifeq (${SPD_MAKE},)
                $(error Error: No services/spd/${SPD}/${SPD}.mk located)
        endif
        $(info Including ${SPD_MAKE})
        include ${SPD_MAKE}

260
261
262
263
264
265
266
267
268
        # If there's BL32 companion for the chosen SPD, we expect that the SPD's
        # Makefile would set NEED_BL32 to "yes". In this case, the build system
        # supports two mutually exclusive options:
        # * BL32 is built from source: then BL32_SOURCES must contain the list
        #   of source files to build BL32
        # * BL32 is a prebuilt binary: then BL32 must point to the image file
        #   that will be included in the FIP
        # If both BL32_SOURCES and BL32 are defined, the binary takes precedence
        # over the sources.
Juan Castillo's avatar
Juan Castillo committed
269
endif
270

Juan Castillo's avatar
Juan Castillo committed
271
272
273
274
275

################################################################################
# Include the platform specific Makefile after the SPD Makefile (the platform
# makefile may use all previous definitions in this file)
################################################################################
276

277
ifeq (${PLAT},)
Juan Castillo's avatar
Juan Castillo committed
278
        $(error "Error: Unknown platform. Please use PLAT=<platform name> to specify the platform")
279
endif
280
281
PLAT_MAKEFILE_FULL	:=	$(shell find plat/ -wholename '*/${PLAT}/${PLAT_MAKEFILE}')
ifeq ($(PLAT_MAKEFILE_FULL),)
Juan Castillo's avatar
Juan Castillo committed
282
        $(error "Error: Invalid platform. The following platforms are available: ${PLATFORMS}")
283
endif
284

285
include ${PLAT_MAKEFILE_FULL}
286

287
288
289
290
291
292
293
294
295
296
# If the platform has not defined ENABLE_PLAT_COMPAT, then enable it by default
ifndef ENABLE_PLAT_COMPAT
ENABLE_PLAT_COMPAT := 1
endif

# Include the platform compatibility helpers for PSCI
ifneq (${ENABLE_PLAT_COMPAT}, 0)
include plat/compat/plat_compat.mk
endif

297
# Include the CPU specific operations makefile. By default all CPU errata
298
# workarounds and CPU specific optimisations are disabled. This can be
299
# overridden by the platform.
300
include lib/cpus/cpu-ops.mk
301

Juan Castillo's avatar
Juan Castillo committed
302
303
304
305
306
307
308
309

################################################################################
# Process platform overrideable behaviour
################################################################################

# Check if -pedantic option should be used
ifeq (${DISABLE_PEDANTIC},0)
        CFLAGS		+= 	-pedantic
310
311
endif

312
# Using the ARM Trusted Firmware BL2 implies that a BL33 image also needs to be
Juan Castillo's avatar
Juan Castillo committed
313
314
# supplied for the FIP and Certificate generation tools. This flag can be
# overridden by the platform.
315
ifdef BL2_SOURCES
316
ifndef EL3_PAYLOAD_BASE
Juan Castillo's avatar
Juan Castillo committed
317
NEED_BL33		?=	yes
318
319
320
321
else
# The BL33 image is not needed when booting an EL3 payload.
NEED_BL33		:=	no
endif
322
323
endif

Juan Castillo's avatar
Juan Castillo committed
324
325
326
327
328
# Process TBB related flags
ifneq (${GENERATE_COT},0)
        # Common cert_create options
        ifneq (${CREATE_KEYS},0)
                $(eval CRT_ARGS += -n)
329
                $(eval FWU_CRT_ARGS += -n)
Juan Castillo's avatar
Juan Castillo committed
330
331
                ifneq (${SAVE_KEYS},0)
                        $(eval CRT_ARGS += -k)
332
                        $(eval FWU_CRT_ARGS += -k)
Juan Castillo's avatar
Juan Castillo committed
333
334
335
336
337
338
                endif
        endif
        # Include TBBR makefile (unless the platform indicates otherwise)
        ifeq (${INCLUDE_TBBR_MK},1)
                include make_helpers/tbbr/tbbr_tools.mk
        endif
339
endif
340

341

Juan Castillo's avatar
Juan Castillo committed
342
343
344
################################################################################
# Auxiliary tools (fip_create, cert_create, etc)
################################################################################
345

Juan Castillo's avatar
Juan Castillo committed
346
347
348
# Variables for use with Certificate Generation Tool
CRTTOOLPATH		?=	tools/cert_create
CRTTOOL			?=	${CRTTOOLPATH}/cert_create
349

Juan Castillo's avatar
Juan Castillo committed
350
351
352
# Variables for use with Firmware Image Package
FIPTOOLPATH		?=	tools/fip_create
FIPTOOL			?=	${FIPTOOLPATH}/fip_create
Jeenu Viswambharan's avatar
Jeenu Viswambharan committed
353

354

Juan Castillo's avatar
Juan Castillo committed
355
356
357
################################################################################
# Build options checks
################################################################################
358

Juan Castillo's avatar
Juan Castillo committed
359
360
$(eval $(call assert_boolean,DEBUG))
$(eval $(call assert_boolean,NS_TIMER_SWITCH))
361
$(eval $(call assert_boolean,RESET_TO_BL31))
362
$(eval $(call assert_boolean,CTX_INCLUDE_FPREGS))
Juan Castillo's avatar
Juan Castillo committed
363
364
365
366
367
368
369
370
$(eval $(call assert_boolean,ASM_ASSERTION))
$(eval $(call assert_boolean,USE_COHERENT_MEM))
$(eval $(call assert_boolean,DISABLE_PEDANTIC))
$(eval $(call assert_boolean,GENERATE_COT))
$(eval $(call assert_boolean,CREATE_KEYS))
$(eval $(call assert_boolean,SAVE_KEYS))
$(eval $(call assert_boolean,TRUSTED_BOARD_BOOT))
$(eval $(call assert_boolean,PROGRAMMABLE_RESET_ADDRESS))
371
$(eval $(call assert_boolean,COLD_BOOT_SINGLE_CPU))
Juan Castillo's avatar
Juan Castillo committed
372
$(eval $(call assert_boolean,PSCI_EXTENDED_STATE_ID))
373
$(eval $(call assert_boolean,ERROR_DEPRECATED))
374
$(eval $(call assert_boolean,ENABLE_PLAT_COMPAT))
375
$(eval $(call assert_boolean,SPIN_ON_BL1_EXIT))
376
$(eval $(call assert_boolean,PL011_GENERIC_UART))
377

378

Juan Castillo's avatar
Juan Castillo committed
379
380
381
382
383
################################################################################
# Add definitions to the cpp preprocessor based on the current build options.
# This is done after including the platform specific makefile to allow the
# platform to overwrite the default options
################################################################################
384

Juan Castillo's avatar
Juan Castillo committed
385
386
387
388
389
390
$(eval $(call add_define,PLAT_${PLAT}))
$(eval $(call add_define,NS_TIMER_SWITCH))
$(eval $(call add_define,RESET_TO_BL31))
$(eval $(call add_define,CTX_INCLUDE_FPREGS))
$(eval $(call add_define,ARM_GIC_ARCH))
$(eval $(call add_define,ARM_CCI_PRODUCT_ID))
391
$(eval $(call add_define,ASM_ASSERTION))
392
$(eval $(call add_define,LOG_LEVEL))
393
$(eval $(call add_define,USE_COHERENT_MEM))
Juan Castillo's avatar
Juan Castillo committed
394
395
$(eval $(call add_define,TRUSTED_BOARD_BOOT))
$(eval $(call add_define,PROGRAMMABLE_RESET_ADDRESS))
396
$(eval $(call add_define,COLD_BOOT_SINGLE_CPU))
397
$(eval $(call add_define,PSCI_EXTENDED_STATE_ID))
398
$(eval $(call add_define,ERROR_DEPRECATED))
399
$(eval $(call add_define,ENABLE_PLAT_COMPAT))
400
$(eval $(call add_define,SPIN_ON_BL1_EXIT))
401
402
403
404
# Define the EL3_PAYLOAD_BASE flag only if it is provided.
ifdef EL3_PAYLOAD_BASE
$(eval $(call add_define,EL3_PAYLOAD_BASE))
endif
405
$(eval $(call add_define,PL011_GENERIC_UART))
406

407

Juan Castillo's avatar
Juan Castillo committed
408
409
410
################################################################################
# Include BL specific makefiles
################################################################################
411

Juan Castillo's avatar
Juan Castillo committed
412
413
414
415
ifdef BL1_SOURCES
NEED_BL1 := yes
include bl1/bl1.mk
endif
416

Juan Castillo's avatar
Juan Castillo committed
417
418
419
420
ifdef BL2_SOURCES
NEED_BL2 := yes
include bl2/bl2.mk
endif
421

422
423
424
425
426
ifdef BL2U_SOURCES
NEED_BL2U := yes
include bl2u/bl2u.mk
endif

Juan Castillo's avatar
Juan Castillo committed
427
ifdef BL31_SOURCES
428
429
430
# When booting an EL3 payload, there is no need to compile the BL31 image nor
# put it in the FIP.
ifndef EL3_PAYLOAD_BASE
Juan Castillo's avatar
Juan Castillo committed
431
432
433
NEED_BL31 := yes
include bl31/bl31.mk
endif
434
endif
435

436

Juan Castillo's avatar
Juan Castillo committed
437
438
439
################################################################################
# Build targets
################################################################################
440

441
.PHONY:	all msg_start clean realclean distclean cscope locate-checkpatch checkcodebase checkpatch fiptool fip fwu_fip certtool
Juan Castillo's avatar
Juan Castillo committed
442
.SUFFIXES:
443

Juan Castillo's avatar
Juan Castillo committed
444
all: msg_start
445

Juan Castillo's avatar
Juan Castillo committed
446
447
msg_start:
	@echo "Building ${PLAT}"
448

449
450
451
452
453
# Check if deprecated declarations should be treated as error or not.
ifeq (${ERROR_DEPRECATED},0)
    CFLAGS		+= 	-Wno-error=deprecated-declarations
endif

Juan Castillo's avatar
Juan Castillo committed
454
455
456
457
# Expand build macros for the different images
ifeq (${NEED_BL1},yes)
$(eval $(call MAKE_BL,1))
endif
458

Juan Castillo's avatar
Juan Castillo committed
459
ifeq (${NEED_BL2},yes)
460
461
$(if ${BL2}, $(eval $(call MAKE_TOOL_ARGS,2,${BL2},tb-fw)),\
	$(eval $(call MAKE_BL,2,tb-fw)))
Juan Castillo's avatar
Juan Castillo committed
462
endif
463

Juan Castillo's avatar
Juan Castillo committed
464
465
ifeq (${NEED_BL31},yes)
BL31_SOURCES += ${SPD_SOURCES}
466
467
$(if ${BL31}, $(eval $(call MAKE_TOOL_ARGS,31,${BL31},soc-fw)),\
	$(eval $(call MAKE_BL,31,soc-fw)))
Juan Castillo's avatar
Juan Castillo committed
468
endif
469

470
471
472
# If a BL32 image is needed but neither BL32 nor BL32_SOURCES is defined, the
# build system will call FIP_ADD_IMG to print a warning message and abort the
# process. Note that the dependency on BL32 applies to the FIP only.
Juan Castillo's avatar
Juan Castillo committed
473
ifeq (${NEED_BL32},yes)
474
475
476
$(if ${BL32}, $(eval $(call MAKE_TOOL_ARGS,32,${BL32},tos-fw)),\
	$(if ${BL32_SOURCES}, $(eval $(call MAKE_BL,32,tos-fw)),\
		$(eval $(call FIP_ADD_IMG,BL32,--tos-fw))))
477
478
endif

Juan Castillo's avatar
Juan Castillo committed
479
480
# Add the BL33 image if required by the platform
ifeq (${NEED_BL33},yes)
481
$(eval $(call FIP_ADD_IMG,BL33,--nt-fw))
482
483
endif

484
485
486
ifeq (${NEED_BL2U},yes)
BL2U_PATH	:= $(if ${BL2U},${BL2U},$(call IMG_BIN,2u))
$(if ${BL2U}, ,$(eval $(call MAKE_BL,2u)))
487
$(eval $(call FWU_FIP_ADD_PAYLOAD,${BL2U_PATH},--ap-fwu-cfg))
488
489
endif

490
491
492
493
494
495
496
497
498
locate-checkpatch:
ifndef CHECKPATCH
	$(error "Please set CHECKPATCH to point to the Linux checkpatch.pl file, eg: CHECKPATCH=../linux/script/checkpatch.pl")
else
ifeq (,$(wildcard ${CHECKPATCH}))
	$(error "The file CHECKPATCH points to cannot be found, use eg: CHECKPATCH=../linux/script/checkpatch.pl")
endif
endif

499
clean:
Juan Castillo's avatar
Juan Castillo committed
500
501
502
503
	@echo "  CLEAN"
	${Q}rm -rf ${BUILD_PLAT}
	${Q}${MAKE} --no-print-directory -C ${FIPTOOLPATH} clean
	${Q}${MAKE} PLAT=${PLAT} --no-print-directory -C ${CRTTOOLPATH} clean
504

505
realclean distclean:
Juan Castillo's avatar
Juan Castillo committed
506
507
508
509
510
	@echo "  REALCLEAN"
	${Q}rm -rf ${BUILD_BASE}
	${Q}rm -f ${CURDIR}/cscope.*
	${Q}${MAKE} --no-print-directory -C ${FIPTOOLPATH} clean
	${Q}${MAKE} PLAT=${PLAT} --no-print-directory -C ${CRTTOOLPATH} clean
511

512
checkcodebase:		locate-checkpatch
Juan Castillo's avatar
Juan Castillo committed
513
514
515
516
517
518
	@echo "  CHECKING STYLE"
	@if test -d .git ; then	\
		git ls-files | grep -v stdlib | while read GIT_FILE ; do ${CHECKPATCH} ${CHECKCODE_ARGS} -f $$GIT_FILE ; done ;	\
	 else			\
		 find . -type f -not -iwholename "*.git*" -not -iwholename "*build*" -not -iwholename "*stdlib*" -exec ${CHECKPATCH} ${CHECKCODE_ARGS} -f {} \; ;	\
	 fi
519
520

checkpatch:		locate-checkpatch
Juan Castillo's avatar
Juan Castillo committed
521
522
523
524
	@echo "  CHECKING STYLE"
	${Q}git log -p ${BASE_COMMIT}..HEAD -- ${CHECK_PATHS} | ${CHECKPATCH} ${CHECKPATCH_ARGS} - || true

certtool: ${CRTTOOL}
525

526
527
.PHONY: ${CRTTOOL}
${CRTTOOL}:
Juan Castillo's avatar
Juan Castillo committed
528
	${Q}${MAKE} PLAT=${PLAT} --no-print-directory -C ${CRTTOOLPATH}
529
	@echo
Juan Castillo's avatar
Juan Castillo committed
530
	@echo "Built $@ successfully"
531
532
	@echo

533
ifneq (${GENERATE_COT},0)
Juan Castillo's avatar
Juan Castillo committed
534
535
536
537
538
539
certificates: ${CRT_DEPS} ${CRTTOOL}
	${Q}${CRTTOOL} ${CRT_ARGS}
	@echo
	@echo "Built $@ successfully"
	@echo "Certificates can be found in ${BUILD_PLAT}"
	@echo
540
541
endif

Juan Castillo's avatar
Juan Castillo committed
542
543
544
545
546
${BUILD_PLAT}/${FIP_NAME}: ${FIP_DEPS} ${FIPTOOL}
	${Q}${FIPTOOL} --dump ${FIP_ARGS} $@
	@echo
	@echo "Built $@ successfully"
	@echo
547

548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
ifneq (${GENERATE_COT},0)
fwu_certificates: ${FWU_CRT_DEPS} ${CRTTOOL}
	${Q}${CRTTOOL} ${FWU_CRT_ARGS}
	@echo
	@echo "Built $@ successfully"
	@echo "FWU certificates can be found in ${BUILD_PLAT}"
	@echo
endif

${BUILD_PLAT}/${FWU_FIP_NAME}: ${FWU_FIP_DEPS} ${FIPTOOL}
	${Q}${FIPTOOL} --dump ${FWU_FIP_ARGS} $@
	@echo
	@echo "Built $@ successfully"
	@echo

Juan Castillo's avatar
Juan Castillo committed
563
564
fiptool: ${FIPTOOL}
fip: ${BUILD_PLAT}/${FIP_NAME}
565
fwu_fip: ${BUILD_PLAT}/${FWU_FIP_NAME}
566

Juan Castillo's avatar
Juan Castillo committed
567
568
569
.PHONY: ${FIPTOOL}
${FIPTOOL}:
	${Q}${MAKE} --no-print-directory -C ${FIPTOOLPATH}
570

571
572
573
574
575
cscope:
	@echo "  CSCOPE"
	${Q}find ${CURDIR} -name "*.[chsS]" > cscope.files
	${Q}cscope -b -q -k

576
help:
577
	@echo "usage: ${MAKE} PLAT=<${PLATFORMS}> [OPTIONS] [TARGET]"
578
579
	@echo ""
	@echo "PLAT is used to specify which platform you wish to build."
580
	@echo "If no platform is specified, PLAT defaults to: ${DEFAULT_PLAT}"
581
	@echo ""
582
583
584
585
586
	@echo "Please refer to the User Guide for a list of all supported options."
	@echo "Note that the build system doesn't track dependencies for build "
	@echo "options. Therefore, if any of the build options are changed "
	@echo "from a previous build, a clean build must be performed."
	@echo ""
587
	@echo "Supported Targets:"
588
	@echo "  all            Build all individual bootloader binaries"
589
	@echo "  bl1            Build the BL1 binary"
590
	@echo "  bl2            Build the BL2 binary"
591
	@echo "  bl2u           Build the BL2U binary"
592
593
	@echo "  bl31           Build the BL31 binary"
	@echo "  bl32           Build the BL32 binary"
Juan Castillo's avatar
Juan Castillo committed
594
	@echo "  certificates   Build the certificates (requires 'GENERATE_COT=1')"
595
	@echo "  fip            Build the Firmware Image Package (FIP)"
596
	@echo "  fwu_fip        Build the FWU Firmware Image Package (FIP)"
597
598
599
600
	@echo "  checkcodebase  Check the coding style of the entire source tree"
	@echo "  checkpatch     Check the coding style on changes in the current"
	@echo "                 branch against BASE_COMMIT (default origin/master)"
	@echo "  clean          Clean the build for the selected platform"
601
	@echo "  cscope         Generate cscope index"
602
	@echo "  distclean      Remove all build artifacts for all platforms"
603
	@echo "  certtool       Build the Certificate generation tool"
604
	@echo "  fiptool        Build the Firmware Image Package(FIP) creation tool"
605
	@echo ""
606
	@echo "Note: most build targets require PLAT to be set to a specific platform."
607
608
609
	@echo ""
	@echo "example: build all targets for the FVP platform:"
	@echo "  CROSS_COMPILE=aarch64-none-elf- make PLAT=fvp all"