Makefile

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