1# 2# Copyright (c) 2013-2014, ARM Limited and Contributors. All rights reserved. 3# 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 31# 32# Trusted Firmware Version 33# 34VERSION_MAJOR := 1 35VERSION_MINOR := 0 36 37# 38# 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 54# NS timer register save and restore 55NS_TIMER_SWITCH := 0 56# By default, Bl1 acts as the reset handler, not BL31 57RESET_TO_BL31 := 0 58# Include FP registers in cpu context 59CTX_INCLUDE_FPREGS := 0 60# 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 63# 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} 66# Build option to choose whether Trusted firmware uses Coherent memory or not. 67USE_COHERENT_MEM := 1 68# Default FIP file name 69FIP_NAME := fip.bin 70# Flags to generate the Chain of Trust 71GENERATE_COT := 0 72CREATE_KEYS := 1 73 74# 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} 79 80ifeq (${V},0) 81 Q=@ 82 CHECKCODE_ARGS += --no-summary --terse 83else 84 Q= 85endif 86export Q 87 88ifneq (${DEBUG}, 0) 89 BUILD_TYPE := debug 90 # Use LOG_LEVEL_INFO by default for debug builds 91 LOG_LEVEL := 40 92else 93 BUILD_TYPE := release 94 # Use LOG_LEVEL_NOTICE by default for release builds 95 LOG_LEVEL := 20 96endif 97 98# 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 105BL_COMMON_SOURCES := common/bl_common.c \ 106 common/tf_printf.c \ 107 common/aarch64/debug.S \ 108 lib/aarch64/cache_helpers.S \ 109 lib/aarch64/misc_helpers.S \ 110 lib/aarch64/xlat_helpers.c \ 111 lib/stdlib/std.c \ 112 plat/common/aarch64/platform_helpers.S 113 114BUILD_BASE := ./build 115BUILD_PLAT := ${BUILD_BASE}/${PLAT}/${BUILD_TYPE} 116 117PLATFORMS := $(shell ls -I common plat/) 118SPDS := $(shell ls -I none services/spd) 119HELP_PLATFORMS := $(shell echo ${PLATFORMS} | sed 's/ /|/g') 120 121# 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 134ifeq (${PLAT},) 135 $(error "Error: Unknown platform. Please use PLAT=<platform name> to specify the platform.") 136endif 137ifeq ($(findstring ${PLAT},${PLATFORMS}),) 138 $(error "Error: Invalid platform. The following platforms are available: ${PLATFORMS}") 139endif 140 141all: msg_start 142 143msg_start: 144 @echo "Building ${PLAT}" 145 146include plat/${PLAT}/platform.mk 147 148# Include the CPU specific operations makefile. By default all CPU errata 149# workarounds and CPU specifc optimisations are disabled. This can be 150# overridden by the platform. 151include lib/cpus/cpu-ops.mk 152 153ifdef BL1_SOURCES 154NEED_BL1 := yes 155include bl1/bl1.mk 156endif 157 158ifdef BL2_SOURCES 159NEED_BL2 := yes 160include bl2/bl2.mk 161# 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 164endif 165 166ifdef BL31_SOURCES 167NEED_BL31 := yes 168include bl31/bl31.mk 169endif 170 171# 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 182 # 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. 186endif 187 188.PHONY: all msg_start clean realclean distclean cscope locate-checkpatch checkcodebase checkpatch fiptool fip certtool 189.SUFFIXES: 190 191INCLUDES += -Iinclude/bl31 \ 192 -Iinclude/bl31/services \ 193 -Iinclude/common \ 194 -Iinclude/drivers \ 195 -Iinclude/drivers/arm \ 196 -Iinclude/drivers/io \ 197 -Iinclude/lib \ 198 -Iinclude/lib/aarch64 \ 199 -Iinclude/lib/cpus/aarch64 \ 200 -Iinclude/plat/common \ 201 -Iinclude/stdlib \ 202 -Iinclude/stdlib/sys \ 203 ${PLAT_INCLUDES} \ 204 ${SPD_INCLUDES} 205 206# 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 216# Process NS_TIMER_SWITCH flag 217$(eval $(call assert_boolean,NS_TIMER_SWITCH)) 218$(eval $(call add_define,NS_TIMER_SWITCH)) 219 220# Process RESET_TO_BL31 flag 221$(eval $(call assert_boolean,RESET_TO_BL31)) 222$(eval $(call add_define,RESET_TO_BL31)) 223 224# Process CTX_INCLUDE_FPREGS flag 225$(eval $(call assert_boolean,CTX_INCLUDE_FPREGS)) 226$(eval $(call add_define,CTX_INCLUDE_FPREGS)) 227 228# Process ARM_GIC_ARCH flag 229$(eval $(call add_define,ARM_GIC_ARCH)) 230 231# Process ASM_ASSERTION flag 232$(eval $(call assert_boolean,ASM_ASSERTION)) 233$(eval $(call add_define,ASM_ASSERTION)) 234 235# Process LOG_LEVEL flag 236$(eval $(call add_define,LOG_LEVEL)) 237 238# Process USE_COHERENT_MEM flag 239$(eval $(call assert_boolean,USE_COHERENT_MEM)) 240$(eval $(call add_define,USE_COHERENT_MEM)) 241 242# Process Generate CoT flags 243$(eval $(call assert_boolean,GENERATE_COT)) 244$(eval $(call assert_boolean,CREATE_KEYS)) 245 246ASFLAGS += -nostdinc -ffreestanding -Wa,--fatal-warnings \ 247 -Werror -Wmissing-include-dirs \ 248 -mgeneral-regs-only -D__ASSEMBLY__ \ 249 ${DEFINES} ${INCLUDES} 250CFLAGS += -nostdinc -pedantic -ffreestanding -Wall \ 251 -Werror -Wmissing-include-dirs \ 252 -mgeneral-regs-only -std=c99 -c -Os \ 253 ${DEFINES} ${INCLUDES} 254CFLAGS += -ffunction-sections -fdata-sections 255 256LDFLAGS += --fatal-warnings -O1 257LDFLAGS += --gc-sections 258 259 260CC := ${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} 269 270# Variables for use with Firmware Image Package 271FIPTOOLPATH ?= tools/fip_create 272FIPTOOL ?= ${FIPTOOLPATH}/fip_create 273fiptool: ${FIPTOOL} 274fip: ${BUILD_PLAT}/${FIP_NAME} 275 276# 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 $(eval FIP_DEPS += certificates) 290 $(eval FIP_ARGS += --trusted-key-cert ${TRUSTED_KEY_CERT}) 291 292 ifneq (${CREATE_KEYS},0) 293 $(eval CRT_ARGS += -n) 294 endif 295 $(eval CRT_ARGS += $(if ${ROT_KEY}, --rot-key ${ROT_KEY})) 296 $(eval CRT_ARGS += $(if ${TRUSTED_WORLD_KEY}, --trusted-world-key ${TRUSTED_WORLD_KEY})) 297 $(eval CRT_ARGS += $(if ${NON_TRUSTED_WORLD_KEY}, --non-trusted-world-key ${NON_TRUSTED_WORLD_KEY})) 298 $(eval CRT_ARGS += --trusted-key-cert ${TRUSTED_KEY_CERT}) 299endif 300 301locate-checkpatch: 302ifndef CHECKPATCH 303 $(error "Please set CHECKPATCH to point to the Linux checkpatch.pl file, eg: CHECKPATCH=../linux/script/checkpatch.pl") 304else 305ifeq (,$(wildcard ${CHECKPATCH})) 306 $(error "The file CHECKPATCH points to cannot be found, use eg: CHECKPATCH=../linux/script/checkpatch.pl") 307endif 308endif 309 310clean: 311 @echo " CLEAN" 312 ${Q}rm -rf ${BUILD_PLAT} 313 ${Q}${MAKE} --no-print-directory -C ${FIPTOOLPATH} clean 314 ${Q}${MAKE} PLAT=${PLAT} --no-print-directory -C ${CRTTOOLPATH} clean 315 316realclean distclean: 317 @echo " REALCLEAN" 318 ${Q}rm -rf ${BUILD_BASE} 319 ${Q}rm -f ${CURDIR}/cscope.* 320 ${Q}${MAKE} --no-print-directory -C ${FIPTOOLPATH} clean 321 ${Q}${MAKE} PLAT=${PLAT} --no-print-directory -C ${CRTTOOLPATH} clean 322 323checkcodebase: locate-checkpatch 324 @echo " CHECKING STYLE" 325 @if test -d .git ; then \ 326 git ls-files | grep -v stdlib | while read GIT_FILE ; do ${CHECKPATCH} ${CHECKCODE_ARGS} -f $$GIT_FILE ; done ; \ 327 else \ 328 find . -type f -not -iwholename "*.git*" -not -iwholename "*build*" -not -iwholename "*stdlib*" -exec ${CHECKPATCH} ${CHECKCODE_ARGS} -f {} \; ; \ 329 fi 330 331checkpatch: locate-checkpatch 332 @echo " CHECKING STYLE" 333 @git format-patch --stdout ${BASE_COMMIT} | ${CHECKPATCH} ${CHECKPATCH_ARGS} - || true 334 335.PHONY: ${CRTTOOL} 336${CRTTOOL}: 337 ${Q}${MAKE} PLAT=${PLAT} --no-print-directory -C ${CRTTOOLPATH} 338 @echo 339 @echo "Built $@ successfully" 340 @echo 341 342.PHONY: ${FIPTOOL} 343${FIPTOOL}: 344 ${Q}${MAKE} --no-print-directory -C ${FIPTOOLPATH} 345 346define match_goals 347$(strip $(foreach goal,$(1),$(filter $(goal),$(MAKECMDGOALS)))) 348endef 349 350# List of rules that involve building things 351BUILD_TARGETS := all bl1 bl2 bl31 bl32 fip 352 353# Does the list of goals specified on the command line include a build target? 354ifneq ($(call match_goals,${BUILD_TARGETS}),) 355IS_ANYTHING_TO_BUILD := 1 356endif 357 358define MAKE_C 359 360$(eval OBJ := $(1)/$(patsubst %.c,%.o,$(notdir $(2)))) 361$(eval PREREQUISITES := $(patsubst %.o,%.d,$(OBJ))) 362 363$(OBJ) : $(2) 364 @echo " CC $$<" 365 $$(Q)$$(CC) $$(CFLAGS) -DIMAGE_BL$(3) -c $$< -o $$@ 366 367 368$(PREREQUISITES) : $(2) 369 @echo " DEPS $$@" 370 @mkdir -p $(1) 371 $$(Q)$$(CC) $$(CFLAGS) -M -MT $(OBJ) -MF $$@ $$< 372 373ifdef IS_ANYTHING_TO_BUILD 374-include $(PREREQUISITES) 375endif 376 377endef 378 379 380define MAKE_S 381 382$(eval OBJ := $(1)/$(patsubst %.S,%.o,$(notdir $(2)))) 383$(eval PREREQUISITES := $(patsubst %.o,%.d,$(OBJ))) 384 385$(OBJ) : $(2) 386 @echo " AS $$<" 387 $$(Q)$$(AS) $$(ASFLAGS) -DIMAGE_BL$(3) -c $$< -o $$@ 388 389$(PREREQUISITES) : $(2) 390 @echo " DEPS $$@" 391 @mkdir -p $(1) 392 $$(Q)$$(AS) $$(ASFLAGS) -M -MT $(OBJ) -MF $$@ $$< 393 394ifdef IS_ANYTHING_TO_BUILD 395-include $(PREREQUISITES) 396endif 397 398endef 399 400 401define MAKE_LD 402 403$(eval PREREQUISITES := $(1).d) 404 405$(1) : $(2) 406 @echo " PP $$<" 407 $$(Q)$$(AS) $$(ASFLAGS) -P -E -D__LINKER__ -o $$@ $$< 408 409$(PREREQUISITES) : $(2) 410 @echo " DEPS $$@" 411 @mkdir -p $$(dir $$@) 412 $$(Q)$$(AS) $$(ASFLAGS) -M -MT $(1) -MF $$@ $$< 413 414ifdef IS_ANYTHING_TO_BUILD 415-include $(PREREQUISITES) 416endif 417 418endef 419 420 421define MAKE_OBJS 422 $(eval C_OBJS := $(filter %.c,$(2))) 423 $(eval REMAIN := $(filter-out %.c,$(2))) 424 $(eval $(foreach obj,$(C_OBJS),$(call MAKE_C,$(1),$(obj),$(3)))) 425 426 $(eval S_OBJS := $(filter %.S,$(REMAIN))) 427 $(eval REMAIN := $(filter-out %.S,$(REMAIN))) 428 $(eval $(foreach obj,$(S_OBJS),$(call MAKE_S,$(1),$(obj),$(3)))) 429 430 $(and $(REMAIN),$(error Unexpected source files present: $(REMAIN))) 431endef 432 433 434# NOTE: The line continuation '\' is required in the next define otherwise we 435# end up with a line-feed characer at the end of the last c filename. 436# Also bare this issue in mind if extending the list of supported filetypes. 437define SOURCES_TO_OBJS 438 $(notdir $(patsubst %.c,%.o,$(filter %.c,$(1)))) \ 439 $(notdir $(patsubst %.S,%.o,$(filter %.S,$(1)))) 440endef 441 442 443# MAKE_TOOL_ARGS macro defines the command line arguments for the FIP and CRT 444# tools at each BL stage. Arguments: 445# $(1) = BL stage (2, 30, 31, 32, 33) 446# $(2) = Binary file 447# $(3) = In FIP (false if empty) 448# $(4) = Create certificates (false if empty) 449# $(5) = Create key certificate (false if empty) 450# $(6) = Private key (optional) 451define MAKE_TOOL_ARGS 452 453$(eval FIP_DEPS += $(if $3,$(2),)) 454$(eval FIP_ARGS += $(if $3,--bl$(1) $(2),)) 455$(eval FIP_ARGS += $(if $4,--bl$(1)-cert $(BUILD_PLAT)/bl$(1).crt)) 456$(eval FIP_ARGS += $(if $4,$(if $5,--bl$(1)-key-cert $(BUILD_PLAT)/bl$(1)_key.crt))) 457 458$(eval CRT_DEPS += $(if $4,$(2),)) 459$(eval CRT_DEPS += $(if $4,$(if $6,$(6),))) 460$(eval CRT_ARGS += $(if $4,--bl$(1) $(2))) 461$(eval CRT_ARGS += $(if $4,$(if $6,--bl$(1)-key $(6)))) 462$(eval CRT_ARGS += $(if $4,--bl$(1)-cert $(BUILD_PLAT)/bl$(1).crt)) 463$(eval CRT_ARGS += $(if $4,$(if $5,--bl$(1)-key-cert $(BUILD_PLAT)/bl$(1)_key.crt))) 464 465endef 466 467 468# MAKE_BL macro defines the targets and options to build each BL image. 469# Arguments: 470# $(1) = BL stage (2, 30, 31, 32, 33) 471# $(2) = In FIP (false if empty) 472# $(3) = Create certificates (false if empty) 473# $(4) = Create key certificate (false if empty) 474# $(5) = Private key (optional) 475define MAKE_BL 476 $(eval BUILD_DIR := ${BUILD_PLAT}/bl$(1)) 477 $(eval SOURCES := $(BL$(1)_SOURCES) $(BL_COMMON_SOURCES) $(PLAT_BL_COMMON_SOURCES)) 478 $(eval OBJS := $(addprefix $(BUILD_DIR)/,$(call SOURCES_TO_OBJS,$(SOURCES)))) 479 $(eval LINKERFILE := $(BUILD_DIR)/bl$(1).ld) 480 $(eval MAPFILE := $(BUILD_DIR)/bl$(1).map) 481 $(eval ELF := $(BUILD_DIR)/bl$(1).elf) 482 $(eval DUMP := $(BUILD_DIR)/bl$(1).dump) 483 $(eval BIN := $(BUILD_PLAT)/bl$(1).bin) 484 485 $(eval $(call MAKE_OBJS,$(BUILD_DIR),$(SOURCES),$(1))) 486 $(eval $(call MAKE_LD,$(LINKERFILE),$(BL$(1)_LINKERFILE))) 487 488$(BUILD_DIR) : 489 $$(Q)mkdir -p "$$@" 490 491$(ELF) : $(OBJS) $(LINKERFILE) 492 @echo " LD $$@" 493 @echo 'const char build_message[] = "Built : "__TIME__", "__DATE__; \ 494 const char version_string[] = "${VERSION_STRING}";' | \ 495 $$(CC) $$(CFLAGS) -xc - -o $(BUILD_DIR)/build_message.o 496 $$(Q)$$(LD) -o $$@ $$(LDFLAGS) -Map=$(MAPFILE) --script $(LINKERFILE) \ 497 $(BUILD_DIR)/build_message.o $(OBJS) 498 499$(DUMP) : $(ELF) 500 @echo " OD $$@" 501 $${Q}$${OD} -dx $$< > $$@ 502 503$(BIN) : $(ELF) 504 @echo " BIN $$@" 505 $$(Q)$$(OC) -O binary $$< $$@ 506 @echo 507 @echo "Built $$@ successfully" 508 @echo 509 510.PHONY : bl$(1) 511bl$(1) : $(BUILD_DIR) $(BIN) $(DUMP) 512 513all : bl$(1) 514 515$(eval $(call MAKE_TOOL_ARGS,$(1),$(BIN),$(2),$(3),$(4),$(5))) 516 517endef 518 519 520ifeq (${NEED_BL1},yes) 521$(eval $(call MAKE_BL,1)) 522endif 523 524ifeq (${NEED_BL2},yes) 525$(if ${BL2}, $(eval $(call MAKE_TOOL_ARGS,2,${BL2},in_fip,${CERTS})),\ 526 $(eval $(call MAKE_BL,2,in_fip,${CERTS}))) 527endif 528 529ifeq (${NEED_BL31},yes) 530BL31_SOURCES += ${SPD_SOURCES} 531$(if ${BL31}, $(eval $(call MAKE_TOOL_ARGS,31,${BL31},in_fip,${CERTS},${CERTS},${BL31_KEY})),\ 532 $(eval $(call MAKE_BL,31,in_fip,${CERTS},${CERTS},${BL31_KEY}))) 533endif 534 535ifeq (${NEED_BL32},yes) 536$(if ${BL32}, $(eval $(call MAKE_TOOL_ARGS,32,${BL32},in_fip,${CERTS},${CERTS},${BL32_KEY})),\ 537 $(eval $(call MAKE_BL,32,in_fip,${CERTS},${CERTS},${BL32_KEY}))) 538endif 539 540ifeq (${NEED_BL30},yes) 541$(if ${BL30}, $(eval $(call MAKE_TOOL_ARGS,30,${BL30},in_fip,${CERTS},${CERTS},${BL30_KEY}))) 542 543# If BL3-0 is needed by the platform then 'BL30' variable must be defined. 544check_bl30: 545 $(if ${BL30},,$(error "To build a FIP for platform ${PLAT}, please set BL30 to point to the SCP firmware")) 546else 547 548# If BL3-0 is not needed by the platform but the user still specified the path 549# to a BL3-0 image then warn him that it will be ignored. 550check_bl30: 551 $(if ${BL30},$(warning "BL3-0 is not supported on platform ${PLAT}, it will just be ignored"),) 552endif 553 554ifeq (${NEED_BL33},yes) 555$(if ${BL33}, $(eval $(call MAKE_TOOL_ARGS,33,${BL33},in_fip,${CERTS},${CERTS},${BL33_KEY}))) 556 557# If BL3-3 is needed by the platform then 'BL33' variable must be defined. 558check_bl33: 559 $(if ${BL33},,$(error "To build a FIP, please set BL33 to point to the Normal World binary, eg: BL33=../uefi/FVP_AARCH64_EFI.fd")) 560else 561 562# If BL3-3 is not needed by the platform but the user still specified the path 563# to a BL3-3 image then warn him that it will be ignored. 564check_bl33: 565 $(if ${BL33},$(warning "BL3-3 is not supported on platform ${PLAT}, it will just be ignored"),) 566endif 567 568# Add the dependency on the certificates 569ifneq (${GENERATE_COT},0) 570 all: certificates 571endif 572 573certificates: ${CRT_DEPS} ${CRTTOOL} check_bl30 check_bl33 574 ${Q}${CRTTOOL} ${CRT_ARGS} 575 @echo 576 @echo "Built $@ successfully" 577 @echo "Certificates can be found in ${BUILD_PLAT}" 578 @echo 579 580${BUILD_PLAT}/${FIP_NAME}: ${FIP_DEPS} ${FIPTOOL} check_bl30 check_bl33 581 ${Q}${FIPTOOL} --dump \ 582 ${FIP_ARGS} \ 583 $@ 584 @echo 585 @echo "Built $@ successfully" 586 @echo 587 588 589cscope: 590 @echo " CSCOPE" 591 ${Q}find ${CURDIR} -name "*.[chsS]" > cscope.files 592 ${Q}cscope -b -q -k 593 594help: 595 @echo "usage: ${MAKE} PLAT=<${HELP_PLATFORMS}> <all|bl1|bl2|bl31|distclean|clean|checkcodebase|checkpatch>" 596 @echo "" 597 @echo "PLAT is used to specify which platform you wish to build." 598 @echo "If no platform is specified, PLAT defaults to: ${DEFAULT_PLAT}" 599 @echo "" 600 @echo "Supported Targets:" 601 @echo " all Build the BL1, BL2 and BL31 binaries" 602 @echo " bl1 Build the BL1 binary" 603 @echo " bl2 Build the BL2 binary" 604 @echo " bl31 Build the BL31 binary" 605 @echo " checkcodebase Check the coding style of the entire source tree" 606 @echo " checkpatch Check the coding style on changes in the current" 607 @echo " branch against BASE_COMMIT (default origin/master)" 608 @echo " clean Clean the build for the selected platform" 609 @echo " cscope Generate cscope index" 610 @echo " distclean Remove all build artifacts for all platforms" 611 @echo " certtool Build the Certificate generation tool" 612 @echo " fiptool Build the Firmware Image Package(FIP) creation tool" 613 @echo "" 614 @echo "note: most build targets require PLAT to be set to a specific platform." 615 @echo "" 616 @echo "example: build all targets for the FVP platform:" 617 @echo " CROSS_COMPILE=aarch64-none-elf- make PLAT=fvp all" 618