14f6ad66aSAchin Gupta# 2c04d2606SDan Handley# Copyright (c) 2013-2015, ARM Limited and Contributors. All rights reserved. 34f6ad66aSAchin Gupta# 44f6ad66aSAchin Gupta# Redistribution and use in source and binary forms, with or without 54f6ad66aSAchin Gupta# modification, are permitted provided that the following conditions are met: 64f6ad66aSAchin Gupta# 74f6ad66aSAchin Gupta# Redistributions of source code must retain the above copyright notice, this 84f6ad66aSAchin Gupta# list of conditions and the following disclaimer. 94f6ad66aSAchin Gupta# 104f6ad66aSAchin Gupta# Redistributions in binary form must reproduce the above copyright notice, 114f6ad66aSAchin Gupta# this list of conditions and the following disclaimer in the documentation 124f6ad66aSAchin Gupta# and/or other materials provided with the distribution. 134f6ad66aSAchin Gupta# 144f6ad66aSAchin Gupta# Neither the name of ARM nor the names of its contributors may be used 154f6ad66aSAchin Gupta# to endorse or promote products derived from this software without specific 164f6ad66aSAchin Gupta# prior written permission. 174f6ad66aSAchin Gupta# 184f6ad66aSAchin Gupta# THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 194f6ad66aSAchin Gupta# AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 204f6ad66aSAchin Gupta# IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 214f6ad66aSAchin Gupta# ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE 224f6ad66aSAchin Gupta# LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 234f6ad66aSAchin Gupta# CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 244f6ad66aSAchin Gupta# SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 254f6ad66aSAchin Gupta# INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 264f6ad66aSAchin Gupta# CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 274f6ad66aSAchin Gupta# ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 284f6ad66aSAchin Gupta# POSSIBILITY OF SUCH DAMAGE. 294f6ad66aSAchin Gupta# 304f6ad66aSAchin Gupta 31e35c4045SJeenu Viswambharan# 32aaa3e722SJuan Castillo# Trusted Firmware Version 33aaa3e722SJuan Castillo# 34c6249aaaSDan HandleyVERSION_MAJOR := 1 356791f52eSDan HandleyVERSION_MINOR := 2 36aaa3e722SJuan Castillo 3788154678SJuan Castillo# Default goal is build all images 3888154678SJuan Castillo.DEFAULT_GOAL := all 3988154678SJuan Castillo 4073c99d4eSJuan Castilloinclude make_helpers/build_macros.mk 4173c99d4eSJuan Castillo 4273c99d4eSJuan Castillo################################################################################ 43e35c4045SJeenu Viswambharan# Default values for build configurations 4473c99d4eSJuan Castillo################################################################################ 45e35c4045SJeenu Viswambharan 46e35c4045SJeenu Viswambharan# Build verbosity 47e35c4045SJeenu ViswambharanV := 0 48e35c4045SJeenu Viswambharan# Debug build 49e35c4045SJeenu ViswambharanDEBUG := 0 50e35c4045SJeenu Viswambharan# Build platform 51e35c4045SJeenu ViswambharanDEFAULT_PLAT := fvp 52e35c4045SJeenu ViswambharanPLAT := ${DEFAULT_PLAT} 53e35c4045SJeenu Viswambharan# SPD choice 54e35c4045SJeenu ViswambharanSPD := none 55e35c4045SJeenu Viswambharan# Base commit to perform code check on 56e35c4045SJeenu ViswambharanBASE_COMMIT := origin/master 572da8d8bfSJeenu Viswambharan# NS timer register save and restore 582da8d8bfSJeenu ViswambharanNS_TIMER_SWITCH := 0 591645d3eeSSandrine Bailleux# By default, BL1 acts as the reset handler, not BL31 60dbad1bacSVikram KanigiriRESET_TO_BL31 := 0 610f21c547SJuan Castillo# Include FP registers in cpu context 620f21c547SJuan CastilloCTX_INCLUDE_FPREGS := 0 632b98e789SSandrine Bailleux# Determine the version of ARM GIC architecture to use for interrupt management 642b98e789SSandrine Bailleux# in EL3. The platform port can change this value if needed. 652b98e789SSandrine BailleuxARM_GIC_ARCH := 2 6623e47edeSVikram Kanigiri# Determine the version of ARM CCI product used in the platform. The platform 6723e47edeSVikram Kanigiri# port can change this value if needed. 6823e47edeSVikram KanigiriARM_CCI_PRODUCT_ID := 400 69bc920128SSoby Mathew# Flag used to indicate if ASM_ASSERTION should be enabled for the build. 70bc920128SSoby Mathew# This defaults to being present in DEBUG builds only. 71bc920128SSoby MathewASM_ASSERTION := ${DEBUG} 728c5fe0b5SSoby Mathew# Build option to choose whether Trusted firmware uses Coherent memory or not. 738c5fe0b5SSoby MathewUSE_COHERENT_MEM := 1 748ee24980SSoby Mathew# Flag used to choose the power state format viz Extended State-ID or the Original 758ee24980SSoby Mathew# format. 768ee24980SSoby MathewPSCI_EXTENDED_STATE_ID := 0 777f48fab9SJuan Castillo# Default FIP file name 787f48fab9SJuan CastilloFIP_NAME := fip.bin 790191262dSYatharth Kochar# Default FWU_FIP file name 800191262dSYatharth KocharFWU_FIP_NAME := fwu_fip.bin 81db6071c9SJuan Castillo# By default, use the -pedantic option in the gcc command line 82db6071c9SJuan CastilloDISABLE_PEDANTIC := 0 836f971622SJuan Castillo# Flags to generate the Chain of Trust 846f971622SJuan CastilloGENERATE_COT := 0 856f971622SJuan CastilloCREATE_KEYS := 1 86fd34e7baSJuan CastilloSAVE_KEYS := 0 876eadf762SJuan Castillo# Flags to build TF with Trusted Boot support 886eadf762SJuan CastilloTRUSTED_BOARD_BOOT := 0 89bf031bbaSSandrine Bailleux# By default, consider that the platform's reset address is not programmable. 90bf031bbaSSandrine Bailleux# The platform Makefile is free to override this value. 91bf031bbaSSandrine BailleuxPROGRAMMABLE_RESET_ADDRESS := 0 927a24cba5SSoby Mathew# Build flag to treat usage of deprecated platform and framework APIs as error. 937a24cba5SSoby MathewERROR_DEPRECATED := 0 94a9bec67dSSandrine Bailleux# By default, consider that the platform may release several CPUs out of reset. 95a9bec67dSSandrine Bailleux# The platform Makefile is free to override this value. 96a9bec67dSSandrine BailleuxCOLD_BOOT_SINGLE_CPU := 0 9735e8c766SSandrine Bailleux# Flag to introduce an infinite loop in BL1 just before it exits into the next 9835e8c766SSandrine Bailleux# image. This is meant to help debugging the post-BL2 phase. 9935e8c766SSandrine BailleuxSPIN_ON_BL1_EXIT := 0 10012f654b6SJuan Castillo# Build PL011 UART driver in minimal generic UART mode 10112f654b6SJuan CastilloPL011_GENERIC_UART := 0 1024f6ad66aSAchin Gupta 10373c99d4eSJuan Castillo 10473c99d4eSJuan Castillo################################################################################ 10573c99d4eSJuan Castillo# Checkpatch script options 10673c99d4eSJuan Castillo################################################################################ 10773c99d4eSJuan Castillo 10873c99d4eSJuan CastilloCHECK_IGNORE := --ignore COMPLEX_MACRO \ 1099b4ee6b3SJuan Castillo --ignore GERRIT_CHANGE_ID \ 1109b4ee6b3SJuan Castillo --ignore GIT_COMMIT_ID 11173c99d4eSJuan CastilloCHECKPATCH_ARGS := --no-tree --no-signoff ${CHECK_IGNORE} 11273c99d4eSJuan CastilloCHECKCODE_ARGS := --no-patch --no-tree --no-signoff ${CHECK_IGNORE} 11395d5353cSSandrine Bailleux# Do not check the coding style on C library files 11473c99d4eSJuan CastilloCHECK_PATHS := $(shell ls -I include -I lib) \ 115662109a5SSandrine Bailleux $(addprefix include/,$(shell ls -I stdlib include)) \ 116662109a5SSandrine Bailleux $(addprefix lib/,$(shell ls -I stdlib lib)) 11736eaaf37SIan Spray 11873c99d4eSJuan Castillo 11973c99d4eSJuan Castillo################################################################################ 12073c99d4eSJuan Castillo# Process build options 12173c99d4eSJuan Castillo################################################################################ 12273c99d4eSJuan Castillo 12373c99d4eSJuan Castillo# Verbose flag 124e35c4045SJeenu Viswambharanifeq (${V},0) 1254f6ad66aSAchin Gupta Q=@ 12636eaaf37SIan Spray CHECKCODE_ARGS += --no-summary --terse 1274f6ad66aSAchin Guptaelse 1284f6ad66aSAchin Gupta Q= 1294f6ad66aSAchin Guptaendif 1302f2cef46SJeenu Viswambharanexport Q 1312f2cef46SJeenu Viswambharan 13273c99d4eSJuan Castillo# Process Debug flag 13373c99d4eSJuan Castillo$(eval $(call add_define,DEBUG)) 134eaaeece2SJames Morrisseyifneq (${DEBUG}, 0) 135eaaeece2SJames Morrissey BUILD_TYPE := debug 13673c99d4eSJuan Castillo CFLAGS += -g 13773c99d4eSJuan Castillo ASFLAGS += -g -Wa,--gdwarf-2 138289c28a8SDan Handley # Use LOG_LEVEL_INFO by default for debug builds 139289c28a8SDan Handley LOG_LEVEL := 40 140eaaeece2SJames Morrisseyelse 141eaaeece2SJames Morrissey BUILD_TYPE := release 14273c99d4eSJuan Castillo $(eval $(call add_define,NDEBUG)) 143289c28a8SDan Handley # Use LOG_LEVEL_NOTICE by default for release builds 144289c28a8SDan Handley LOG_LEVEL := 20 145eaaeece2SJames Morrisseyendif 146eaaeece2SJames Morrissey 147aaa3e722SJuan Castillo# Default build string (git branch and commit) 148aaa3e722SJuan Castilloifeq (${BUILD_STRING},) 149aaa3e722SJuan Castillo BUILD_STRING := $(shell git log -n 1 --pretty=format:"%h") 150aaa3e722SJuan Castilloendif 151aaa3e722SJuan CastilloVERSION_STRING := v${VERSION_MAJOR}.${VERSION_MINOR}(${BUILD_TYPE}):${BUILD_STRING} 152aaa3e722SJuan Castillo 15373c99d4eSJuan Castillo# The cert_create tool cannot generate certificates individually, so we use the 15473c99d4eSJuan Castillo# target 'certificates' to create them all 15573c99d4eSJuan Castilloifneq (${GENERATE_COT},0) 15673c99d4eSJuan Castillo FIP_DEPS += certificates 1570191262dSYatharth Kochar FWU_FIP_DEPS += fwu_certificates 15873c99d4eSJuan Castilloendif 15973c99d4eSJuan Castillo 16073c99d4eSJuan Castillo 16173c99d4eSJuan Castillo################################################################################ 16273c99d4eSJuan Castillo# Toolchain 16373c99d4eSJuan Castillo################################################################################ 16473c99d4eSJuan Castillo 16573c99d4eSJuan CastilloCC := ${CROSS_COMPILE}gcc 16673c99d4eSJuan CastilloCPP := ${CROSS_COMPILE}cpp 16773c99d4eSJuan CastilloAS := ${CROSS_COMPILE}gcc 16873c99d4eSJuan CastilloAR := ${CROSS_COMPILE}ar 16973c99d4eSJuan CastilloLD := ${CROSS_COMPILE}ld 17073c99d4eSJuan CastilloOC := ${CROSS_COMPILE}objcopy 17173c99d4eSJuan CastilloOD := ${CROSS_COMPILE}objdump 17273c99d4eSJuan CastilloNM := ${CROSS_COMPILE}nm 17373c99d4eSJuan CastilloPP := ${CROSS_COMPILE}gcc -E 17473c99d4eSJuan Castillo 17573c99d4eSJuan CastilloASFLAGS += -nostdinc -ffreestanding -Wa,--fatal-warnings \ 17673c99d4eSJuan Castillo -Werror -Wmissing-include-dirs \ 17773c99d4eSJuan Castillo -mgeneral-regs-only -D__ASSEMBLY__ \ 17873c99d4eSJuan Castillo ${DEFINES} ${INCLUDES} 17973c99d4eSJuan CastilloCFLAGS += -nostdinc -ffreestanding -Wall \ 18073c99d4eSJuan Castillo -Werror -Wmissing-include-dirs \ 181fa1d3712SJuan Castillo -mgeneral-regs-only -mstrict-align \ 182fa1d3712SJuan Castillo -std=c99 -c -Os \ 18373c99d4eSJuan Castillo ${DEFINES} ${INCLUDES} 18473c99d4eSJuan CastilloCFLAGS += -ffunction-sections -fdata-sections 18573c99d4eSJuan Castillo 18673c99d4eSJuan CastilloLDFLAGS += --fatal-warnings -O1 18773c99d4eSJuan CastilloLDFLAGS += --gc-sections 18873c99d4eSJuan Castillo 18973c99d4eSJuan Castillo 19073c99d4eSJuan Castillo################################################################################ 19173c99d4eSJuan Castillo# Common sources and include directories 19273c99d4eSJuan Castillo################################################################################ 19373c99d4eSJuan Castillo 19473c99d4eSJuan CastilloBL_COMMON_SOURCES += common/bl_common.c \ 195b79af934SSoby Mathew common/tf_printf.c \ 196626ed510SSoby Mathew common/aarch64/debug.S \ 197bee82417SDan Handley lib/aarch64/cache_helpers.S \ 198bee82417SDan Handley lib/aarch64/misc_helpers.S \ 199bee82417SDan Handley lib/aarch64/xlat_helpers.c \ 200bee82417SDan Handley lib/stdlib/std.c \ 201bee82417SDan Handley plat/common/aarch64/platform_helpers.S 202d7a6b0f8SRyan Harkin 20348bfb88eSYatharth KocharINCLUDES += -Iinclude/bl1 \ 20448bfb88eSYatharth Kochar -Iinclude/bl31 \ 2054ecca339SDan Handley -Iinclude/bl31/services \ 2064ecca339SDan Handley -Iinclude/common \ 2074ecca339SDan Handley -Iinclude/drivers \ 2084ecca339SDan Handley -Iinclude/drivers/arm \ 2091779ba6bSJuan Castillo -Iinclude/drivers/auth \ 210935db693SDan Handley -Iinclude/drivers/io \ 211c13b2e32SVarun Wadekar -Iinclude/drivers/ti/uart \ 2124ecca339SDan Handley -Iinclude/lib \ 2134ecca339SDan Handley -Iinclude/lib/aarch64 \ 214add40351SSoby Mathew -Iinclude/lib/cpus/aarch64 \ 2155f0cdb05SDan Handley -Iinclude/plat/common \ 216d7a6b0f8SRyan Harkin -Iinclude/stdlib \ 217d7a6b0f8SRyan Harkin -Iinclude/stdlib/sys \ 218375f538aSAchin Gupta ${PLAT_INCLUDES} \ 219375f538aSAchin Gupta ${SPD_INCLUDES} 2204f6ad66aSAchin Gupta 22173c99d4eSJuan Castillo 22273c99d4eSJuan Castillo################################################################################ 22373c99d4eSJuan Castillo# Generic definitions 22473c99d4eSJuan Castillo################################################################################ 22573c99d4eSJuan Castillo 22673c99d4eSJuan CastilloBUILD_BASE := ./build 22773c99d4eSJuan CastilloBUILD_PLAT := ${BUILD_BASE}/${PLAT}/${BUILD_TYPE} 22873c99d4eSJuan Castillo 22973c99d4eSJuan CastilloPLAT_MAKEFILE := platform.mk 23073c99d4eSJuan Castillo# Generate the platforms list by recursively searching for all directories 23173c99d4eSJuan Castillo# under /plat containing a PLAT_MAKEFILE. Append each platform with a `|` 23273c99d4eSJuan Castillo# char and strip out the final '|'. 23373c99d4eSJuan CastilloPLATFORMS := $(shell find plat/ -name '${PLAT_MAKEFILE}' -print0 | \ 23473c99d4eSJuan Castillo sed -r 's%[^\x00]*\/([^/]*)\/${PLAT_MAKEFILE}\x00%\1|%g' | \ 23573c99d4eSJuan Castillo sed -r 's/\|$$//') 23673c99d4eSJuan CastilloSPDS := $(shell ls -I none services/spd) 23773c99d4eSJuan Castillo 23873c99d4eSJuan Castillo# Platforms providing their own TBB makefile may override this value 23973c99d4eSJuan CastilloINCLUDE_TBBR_MK := 1 24073c99d4eSJuan Castillo 24173c99d4eSJuan Castillo 24273c99d4eSJuan Castillo################################################################################ 24373c99d4eSJuan Castillo# Include SPD Makefile if one has been specified 24473c99d4eSJuan Castillo################################################################################ 24573c99d4eSJuan Castillo 24673c99d4eSJuan Castilloifneq (${SPD},none) 2474c117f6cSSandrine Bailleuxifdef EL3_PAYLOAD_BASE 2484c117f6cSSandrine Bailleux $(warning "SPD and EL3_PAYLOAD_BASE are incompatible build options.") 2494c117f6cSSandrine Bailleux $(warning "The SPD and its BL32 companion will be present but ignored.") 2504c117f6cSSandrine Bailleuxendif 25173c99d4eSJuan Castillo # We expect to locate an spd.mk under the specified SPD directory 25273c99d4eSJuan Castillo SPD_MAKE := $(shell m="services/spd/${SPD}/${SPD}.mk"; [ -f "$$m" ] && echo "$$m") 25373c99d4eSJuan Castillo 25473c99d4eSJuan Castillo ifeq (${SPD_MAKE},) 25573c99d4eSJuan Castillo $(error Error: No services/spd/${SPD}/${SPD}.mk located) 25673c99d4eSJuan Castillo endif 25773c99d4eSJuan Castillo $(info Including ${SPD_MAKE}) 25873c99d4eSJuan Castillo include ${SPD_MAKE} 25973c99d4eSJuan Castillo 26070d1fc53SJuan Castillo # If there's BL32 companion for the chosen SPD, we expect that the SPD's 26170d1fc53SJuan Castillo # Makefile would set NEED_BL32 to "yes". In this case, the build system 26270d1fc53SJuan Castillo # supports two mutually exclusive options: 26370d1fc53SJuan Castillo # * BL32 is built from source: then BL32_SOURCES must contain the list 26470d1fc53SJuan Castillo # of source files to build BL32 26570d1fc53SJuan Castillo # * BL32 is a prebuilt binary: then BL32 must point to the image file 26670d1fc53SJuan Castillo # that will be included in the FIP 26770d1fc53SJuan Castillo # If both BL32_SOURCES and BL32 are defined, the binary takes precedence 26870d1fc53SJuan Castillo # over the sources. 269e35c4045SJeenu Viswambharanendif 270e35c4045SJeenu Viswambharan 271c04d2606SDan Handley 27273c99d4eSJuan Castillo################################################################################ 27373c99d4eSJuan Castillo# Include the platform specific Makefile after the SPD Makefile (the platform 27473c99d4eSJuan Castillo# makefile may use all previous definitions in this file) 27573c99d4eSJuan Castillo################################################################################ 2762da8d8bfSJeenu Viswambharan 27773c99d4eSJuan Castilloifeq (${PLAT},) 27873c99d4eSJuan Castillo $(error "Error: Unknown platform. Please use PLAT=<platform name> to specify the platform") 27973c99d4eSJuan Castilloendif 28073c99d4eSJuan CastilloPLAT_MAKEFILE_FULL := $(shell find plat/ -wholename '*/${PLAT}/${PLAT_MAKEFILE}') 28173c99d4eSJuan Castilloifeq ($(PLAT_MAKEFILE_FULL),) 28273c99d4eSJuan Castillo $(error "Error: Invalid platform. The following platforms are available: ${PLATFORMS}") 28373c99d4eSJuan Castilloendif 284dbad1bacSVikram Kanigiri 28573c99d4eSJuan Castilloinclude ${PLAT_MAKEFILE_FULL} 2860f21c547SJuan Castillo 28793271a1eSAchin Gupta# If the platform has not defined ENABLE_PLAT_COMPAT, then enable it by default 28893271a1eSAchin Guptaifndef ENABLE_PLAT_COMPAT 28993271a1eSAchin GuptaENABLE_PLAT_COMPAT := 1 29093271a1eSAchin Guptaendif 29193271a1eSAchin Gupta 29293271a1eSAchin Gupta# Include the platform compatibility helpers for PSCI 29393271a1eSAchin Guptaifneq (${ENABLE_PLAT_COMPAT}, 0) 29493271a1eSAchin Guptainclude plat/compat/plat_compat.mk 29593271a1eSAchin Guptaendif 29693271a1eSAchin Gupta 29773c99d4eSJuan Castillo# Include the CPU specific operations makefile. By default all CPU errata 2981645d3eeSSandrine Bailleux# workarounds and CPU specific optimisations are disabled. This can be 29973c99d4eSJuan Castillo# overridden by the platform. 30073c99d4eSJuan Castilloinclude lib/cpus/cpu-ops.mk 3014f6ad66aSAchin Gupta 3024f6ad66aSAchin Gupta 30373c99d4eSJuan Castillo################################################################################ 30473c99d4eSJuan Castillo# Process platform overrideable behaviour 30573c99d4eSJuan Castillo################################################################################ 3064f6ad66aSAchin Gupta 30773c99d4eSJuan Castillo# Check if -pedantic option should be used 30873c99d4eSJuan Castilloifeq (${DISABLE_PEDANTIC},0) 30973c99d4eSJuan Castillo CFLAGS += -pedantic 31073c99d4eSJuan Castilloendif 311f58ad36fSHarry Liebel 3121645d3eeSSandrine Bailleux# Using the ARM Trusted Firmware BL2 implies that a BL33 image also needs to be 31373c99d4eSJuan Castillo# supplied for the FIP and Certificate generation tools. This flag can be 31473c99d4eSJuan Castillo# overridden by the platform. 31573c99d4eSJuan Castilloifdef BL2_SOURCES 3164c117f6cSSandrine Bailleuxifndef EL3_PAYLOAD_BASE 31773c99d4eSJuan CastilloNEED_BL33 ?= yes 3184c117f6cSSandrine Bailleuxelse 3194c117f6cSSandrine Bailleux# The BL33 image is not needed when booting an EL3 payload. 3204c117f6cSSandrine BailleuxNEED_BL33 := no 3214c117f6cSSandrine Bailleuxendif 32273c99d4eSJuan Castilloendif 3236f971622SJuan Castillo 32473c99d4eSJuan Castillo# Process TBB related flags 3256f971622SJuan Castilloifneq (${GENERATE_COT},0) 32673c99d4eSJuan Castillo # Common cert_create options 3276f971622SJuan Castillo ifneq (${CREATE_KEYS},0) 3286f971622SJuan Castillo $(eval CRT_ARGS += -n) 3290191262dSYatharth Kochar $(eval FWU_CRT_ARGS += -n) 330fd34e7baSJuan Castillo ifneq (${SAVE_KEYS},0) 331fd34e7baSJuan Castillo $(eval CRT_ARGS += -k) 3320191262dSYatharth Kochar $(eval FWU_CRT_ARGS += -k) 333fd34e7baSJuan Castillo endif 3346f971622SJuan Castillo endif 33573c99d4eSJuan Castillo # Include TBBR makefile (unless the platform indicates otherwise) 33673c99d4eSJuan Castillo ifeq (${INCLUDE_TBBR_MK},1) 33773c99d4eSJuan Castillo include make_helpers/tbbr/tbbr_tools.mk 33873c99d4eSJuan Castillo endif 3396f971622SJuan Castilloendif 3406f971622SJuan Castillo 34173c99d4eSJuan Castillo 34273c99d4eSJuan Castillo################################################################################ 34373c99d4eSJuan Castillo# Auxiliary tools (fip_create, cert_create, etc) 34473c99d4eSJuan Castillo################################################################################ 34573c99d4eSJuan Castillo 34673c99d4eSJuan Castillo# Variables for use with Certificate Generation Tool 34773c99d4eSJuan CastilloCRTTOOLPATH ?= tools/cert_create 34873c99d4eSJuan CastilloCRTTOOL ?= ${CRTTOOLPATH}/cert_create 34973c99d4eSJuan Castillo 35073c99d4eSJuan Castillo# Variables for use with Firmware Image Package 35173c99d4eSJuan CastilloFIPTOOLPATH ?= tools/fip_create 35273c99d4eSJuan CastilloFIPTOOL ?= ${FIPTOOLPATH}/fip_create 35373c99d4eSJuan Castillo 35473c99d4eSJuan Castillo 35573c99d4eSJuan Castillo################################################################################ 35673c99d4eSJuan Castillo# Build options checks 35773c99d4eSJuan Castillo################################################################################ 35873c99d4eSJuan Castillo 35973c99d4eSJuan Castillo$(eval $(call assert_boolean,DEBUG)) 36073c99d4eSJuan Castillo$(eval $(call assert_boolean,NS_TIMER_SWITCH)) 36173c99d4eSJuan Castillo$(eval $(call assert_boolean,RESET_TO_BL31)) 36273c99d4eSJuan Castillo$(eval $(call assert_boolean,CTX_INCLUDE_FPREGS)) 36373c99d4eSJuan Castillo$(eval $(call assert_boolean,ASM_ASSERTION)) 36473c99d4eSJuan Castillo$(eval $(call assert_boolean,USE_COHERENT_MEM)) 36573c99d4eSJuan Castillo$(eval $(call assert_boolean,DISABLE_PEDANTIC)) 36673c99d4eSJuan Castillo$(eval $(call assert_boolean,GENERATE_COT)) 36773c99d4eSJuan Castillo$(eval $(call assert_boolean,CREATE_KEYS)) 36873c99d4eSJuan Castillo$(eval $(call assert_boolean,SAVE_KEYS)) 36973c99d4eSJuan Castillo$(eval $(call assert_boolean,TRUSTED_BOARD_BOOT)) 37073c99d4eSJuan Castillo$(eval $(call assert_boolean,PROGRAMMABLE_RESET_ADDRESS)) 371a9bec67dSSandrine Bailleux$(eval $(call assert_boolean,COLD_BOOT_SINGLE_CPU)) 37273c99d4eSJuan Castillo$(eval $(call assert_boolean,PSCI_EXTENDED_STATE_ID)) 3737a24cba5SSoby Mathew$(eval $(call assert_boolean,ERROR_DEPRECATED)) 37493271a1eSAchin Gupta$(eval $(call assert_boolean,ENABLE_PLAT_COMPAT)) 37535e8c766SSandrine Bailleux$(eval $(call assert_boolean,SPIN_ON_BL1_EXIT)) 37612f654b6SJuan Castillo$(eval $(call assert_boolean,PL011_GENERIC_UART)) 37773c99d4eSJuan Castillo 37873c99d4eSJuan Castillo 37973c99d4eSJuan Castillo################################################################################ 38073c99d4eSJuan Castillo# Add definitions to the cpp preprocessor based on the current build options. 38173c99d4eSJuan Castillo# This is done after including the platform specific makefile to allow the 38273c99d4eSJuan Castillo# platform to overwrite the default options 38373c99d4eSJuan Castillo################################################################################ 38473c99d4eSJuan Castillo 38573c99d4eSJuan Castillo$(eval $(call add_define,PLAT_${PLAT})) 38673c99d4eSJuan Castillo$(eval $(call add_define,NS_TIMER_SWITCH)) 38773c99d4eSJuan Castillo$(eval $(call add_define,RESET_TO_BL31)) 38873c99d4eSJuan Castillo$(eval $(call add_define,CTX_INCLUDE_FPREGS)) 38973c99d4eSJuan Castillo$(eval $(call add_define,ARM_GIC_ARCH)) 39073c99d4eSJuan Castillo$(eval $(call add_define,ARM_CCI_PRODUCT_ID)) 39173c99d4eSJuan Castillo$(eval $(call add_define,ASM_ASSERTION)) 39273c99d4eSJuan Castillo$(eval $(call add_define,LOG_LEVEL)) 39373c99d4eSJuan Castillo$(eval $(call add_define,USE_COHERENT_MEM)) 39473c99d4eSJuan Castillo$(eval $(call add_define,TRUSTED_BOARD_BOOT)) 39573c99d4eSJuan Castillo$(eval $(call add_define,PROGRAMMABLE_RESET_ADDRESS)) 396a9bec67dSSandrine Bailleux$(eval $(call add_define,COLD_BOOT_SINGLE_CPU)) 39773c99d4eSJuan Castillo$(eval $(call add_define,PSCI_EXTENDED_STATE_ID)) 3987a24cba5SSoby Mathew$(eval $(call add_define,ERROR_DEPRECATED)) 39993271a1eSAchin Gupta$(eval $(call add_define,ENABLE_PLAT_COMPAT)) 40035e8c766SSandrine Bailleux$(eval $(call add_define,SPIN_ON_BL1_EXIT)) 4014c117f6cSSandrine Bailleux# Define the EL3_PAYLOAD_BASE flag only if it is provided. 4024c117f6cSSandrine Bailleuxifdef EL3_PAYLOAD_BASE 4034c117f6cSSandrine Bailleux$(eval $(call add_define,EL3_PAYLOAD_BASE)) 4044c117f6cSSandrine Bailleuxendif 40512f654b6SJuan Castillo$(eval $(call add_define,PL011_GENERIC_UART)) 40673c99d4eSJuan Castillo 40773c99d4eSJuan Castillo 40873c99d4eSJuan Castillo################################################################################ 40973c99d4eSJuan Castillo# Include BL specific makefiles 41073c99d4eSJuan Castillo################################################################################ 41173c99d4eSJuan Castillo 41273c99d4eSJuan Castilloifdef BL1_SOURCES 41373c99d4eSJuan CastilloNEED_BL1 := yes 41473c99d4eSJuan Castilloinclude bl1/bl1.mk 41573c99d4eSJuan Castilloendif 41673c99d4eSJuan Castillo 41773c99d4eSJuan Castilloifdef BL2_SOURCES 41873c99d4eSJuan CastilloNEED_BL2 := yes 41973c99d4eSJuan Castilloinclude bl2/bl2.mk 42073c99d4eSJuan Castilloendif 42173c99d4eSJuan Castillo 4229003fa0bSYatharth Kocharifdef BL2U_SOURCES 4239003fa0bSYatharth KocharNEED_BL2U := yes 4249003fa0bSYatharth Kocharinclude bl2u/bl2u.mk 4259003fa0bSYatharth Kocharendif 4269003fa0bSYatharth Kochar 42773c99d4eSJuan Castilloifdef BL31_SOURCES 4284c117f6cSSandrine Bailleux# When booting an EL3 payload, there is no need to compile the BL31 image nor 4294c117f6cSSandrine Bailleux# put it in the FIP. 4304c117f6cSSandrine Bailleuxifndef EL3_PAYLOAD_BASE 43173c99d4eSJuan CastilloNEED_BL31 := yes 43273c99d4eSJuan Castilloinclude bl31/bl31.mk 43373c99d4eSJuan Castilloendif 4344c117f6cSSandrine Bailleuxendif 43573c99d4eSJuan Castillo 43673c99d4eSJuan Castillo 43773c99d4eSJuan Castillo################################################################################ 43873c99d4eSJuan Castillo# Build targets 43973c99d4eSJuan Castillo################################################################################ 44073c99d4eSJuan Castillo 4410191262dSYatharth Kochar.PHONY: all msg_start clean realclean distclean cscope locate-checkpatch checkcodebase checkpatch fiptool fip fwu_fip certtool 44273c99d4eSJuan Castillo.SUFFIXES: 44373c99d4eSJuan Castillo 44473c99d4eSJuan Castilloall: msg_start 44573c99d4eSJuan Castillo 44673c99d4eSJuan Castillomsg_start: 44773c99d4eSJuan Castillo @echo "Building ${PLAT}" 44873c99d4eSJuan Castillo 4497a24cba5SSoby Mathew# Check if deprecated declarations should be treated as error or not. 4507a24cba5SSoby Mathewifeq (${ERROR_DEPRECATED},0) 4517a24cba5SSoby Mathew CFLAGS += -Wno-error=deprecated-declarations 4527a24cba5SSoby Mathewendif 4537a24cba5SSoby Mathew 45473c99d4eSJuan Castillo# Expand build macros for the different images 45573c99d4eSJuan Castilloifeq (${NEED_BL1},yes) 45673c99d4eSJuan Castillo$(eval $(call MAKE_BL,1)) 45773c99d4eSJuan Castilloendif 45873c99d4eSJuan Castillo 45973c99d4eSJuan Castilloifeq (${NEED_BL2},yes) 460*8f0617efSJuan Castillo$(if ${BL2}, $(eval $(call MAKE_TOOL_ARGS,2,${BL2},tb-fw)),\ 461*8f0617efSJuan Castillo $(eval $(call MAKE_BL,2,tb-fw))) 46273c99d4eSJuan Castilloendif 46373c99d4eSJuan Castillo 46473c99d4eSJuan Castilloifeq (${NEED_BL31},yes) 46573c99d4eSJuan CastilloBL31_SOURCES += ${SPD_SOURCES} 466*8f0617efSJuan Castillo$(if ${BL31}, $(eval $(call MAKE_TOOL_ARGS,31,${BL31},soc-fw)),\ 467*8f0617efSJuan Castillo $(eval $(call MAKE_BL,31,soc-fw))) 46873c99d4eSJuan Castilloendif 46973c99d4eSJuan Castillo 47070d1fc53SJuan Castillo# If a BL32 image is needed but neither BL32 nor BL32_SOURCES is defined, the 47170d1fc53SJuan Castillo# build system will call FIP_ADD_IMG to print a warning message and abort the 47270d1fc53SJuan Castillo# process. Note that the dependency on BL32 applies to the FIP only. 47373c99d4eSJuan Castilloifeq (${NEED_BL32},yes) 474*8f0617efSJuan Castillo$(if ${BL32}, $(eval $(call MAKE_TOOL_ARGS,32,${BL32},tos-fw)),\ 475*8f0617efSJuan Castillo $(if ${BL32_SOURCES}, $(eval $(call MAKE_BL,32,tos-fw)),\ 476*8f0617efSJuan Castillo $(eval $(call FIP_ADD_IMG,BL32,--tos-fw)))) 47773c99d4eSJuan Castilloendif 47873c99d4eSJuan Castillo 47973c99d4eSJuan Castillo# Add the BL33 image if required by the platform 48073c99d4eSJuan Castilloifeq (${NEED_BL33},yes) 481*8f0617efSJuan Castillo$(eval $(call FIP_ADD_IMG,BL33,--nt-fw)) 482db6071c9SJuan Castilloendif 483db6071c9SJuan Castillo 4849003fa0bSYatharth Kocharifeq (${NEED_BL2U},yes) 4859003fa0bSYatharth KocharBL2U_PATH := $(if ${BL2U},${BL2U},$(call IMG_BIN,2u)) 4869003fa0bSYatharth Kochar$(if ${BL2U}, ,$(eval $(call MAKE_BL,2u))) 487*8f0617efSJuan Castillo$(eval $(call FWU_FIP_ADD_PAYLOAD,${BL2U_PATH},--ap-fwu-cfg)) 4889003fa0bSYatharth Kocharendif 4899003fa0bSYatharth Kochar 49036eaaf37SIan Spraylocate-checkpatch: 49136eaaf37SIan Sprayifndef CHECKPATCH 49236eaaf37SIan Spray $(error "Please set CHECKPATCH to point to the Linux checkpatch.pl file, eg: CHECKPATCH=../linux/script/checkpatch.pl") 49336eaaf37SIan Sprayelse 49436eaaf37SIan Sprayifeq (,$(wildcard ${CHECKPATCH})) 49536eaaf37SIan Spray $(error "The file CHECKPATCH points to cannot be found, use eg: CHECKPATCH=../linux/script/checkpatch.pl") 49636eaaf37SIan Sprayendif 49736eaaf37SIan Sprayendif 49836eaaf37SIan Spray 4994f6ad66aSAchin Guptaclean: 5004f6ad66aSAchin Gupta @echo " CLEAN" 50125cff83eSRyan Harkin ${Q}rm -rf ${BUILD_PLAT} 5022f2cef46SJeenu Viswambharan ${Q}${MAKE} --no-print-directory -C ${FIPTOOLPATH} clean 5036f971622SJuan Castillo ${Q}${MAKE} PLAT=${PLAT} --no-print-directory -C ${CRTTOOLPATH} clean 5044f6ad66aSAchin Gupta 505eaaeece2SJames Morrisseyrealclean distclean: 506eaaeece2SJames Morrissey @echo " REALCLEAN" 507eaaeece2SJames Morrissey ${Q}rm -rf ${BUILD_BASE} 50835fab8c9SJoakim Bech ${Q}rm -f ${CURDIR}/cscope.* 5092f2cef46SJeenu Viswambharan ${Q}${MAKE} --no-print-directory -C ${FIPTOOLPATH} clean 5106f971622SJuan Castillo ${Q}${MAKE} PLAT=${PLAT} --no-print-directory -C ${CRTTOOLPATH} clean 5114f6ad66aSAchin Gupta 51236eaaf37SIan Spraycheckcodebase: locate-checkpatch 51336eaaf37SIan Spray @echo " CHECKING STYLE" 51436eaaf37SIan Spray @if test -d .git ; then \ 5154f2104ffSJuan Castillo git ls-files | grep -v stdlib | while read GIT_FILE ; do ${CHECKPATCH} ${CHECKCODE_ARGS} -f $$GIT_FILE ; done ; \ 51636eaaf37SIan Spray else \ 5174f2104ffSJuan Castillo find . -type f -not -iwholename "*.git*" -not -iwholename "*build*" -not -iwholename "*stdlib*" -exec ${CHECKPATCH} ${CHECKCODE_ARGS} -f {} \; ; \ 51836eaaf37SIan Spray fi 51936eaaf37SIan Spray 52036eaaf37SIan Spraycheckpatch: locate-checkpatch 52136eaaf37SIan Spray @echo " CHECKING STYLE" 522662109a5SSandrine Bailleux ${Q}git log -p ${BASE_COMMIT}..HEAD -- ${CHECK_PATHS} | ${CHECKPATCH} ${CHECKPATCH_ARGS} - || true 52336eaaf37SIan Spray 52473c99d4eSJuan Castillocerttool: ${CRTTOOL} 52573c99d4eSJuan Castillo 5266f971622SJuan Castillo.PHONY: ${CRTTOOL} 5276f971622SJuan Castillo${CRTTOOL}: 5286f971622SJuan Castillo ${Q}${MAKE} PLAT=${PLAT} --no-print-directory -C ${CRTTOOLPATH} 5296f971622SJuan Castillo @echo 5306f971622SJuan Castillo @echo "Built $@ successfully" 5316f971622SJuan Castillo @echo 5326f971622SJuan Castillo 5336f971622SJuan Castilloifneq (${GENERATE_COT},0) 53473c99d4eSJuan Castillocertificates: ${CRT_DEPS} ${CRTTOOL} 5356f971622SJuan Castillo ${Q}${CRTTOOL} ${CRT_ARGS} 5366f971622SJuan Castillo @echo 5376f971622SJuan Castillo @echo "Built $@ successfully" 5386f971622SJuan Castillo @echo "Certificates can be found in ${BUILD_PLAT}" 5396f971622SJuan Castillo @echo 54073c99d4eSJuan Castilloendif 54127713fb4SSoby Mathew 54273c99d4eSJuan Castillo${BUILD_PLAT}/${FIP_NAME}: ${FIP_DEPS} ${FIPTOOL} 54373c99d4eSJuan Castillo ${Q}${FIPTOOL} --dump ${FIP_ARGS} $@ 544f58ad36fSHarry Liebel @echo 5452f2cef46SJeenu Viswambharan @echo "Built $@ successfully" 5462f2cef46SJeenu Viswambharan @echo 547f58ad36fSHarry Liebel 5480191262dSYatharth Kocharifneq (${GENERATE_COT},0) 5490191262dSYatharth Kocharfwu_certificates: ${FWU_CRT_DEPS} ${CRTTOOL} 5500191262dSYatharth Kochar ${Q}${CRTTOOL} ${FWU_CRT_ARGS} 5510191262dSYatharth Kochar @echo 5520191262dSYatharth Kochar @echo "Built $@ successfully" 5530191262dSYatharth Kochar @echo "FWU certificates can be found in ${BUILD_PLAT}" 5540191262dSYatharth Kochar @echo 5550191262dSYatharth Kocharendif 5560191262dSYatharth Kochar 5570191262dSYatharth Kochar${BUILD_PLAT}/${FWU_FIP_NAME}: ${FWU_FIP_DEPS} ${FIPTOOL} 5580191262dSYatharth Kochar ${Q}${FIPTOOL} --dump ${FWU_FIP_ARGS} $@ 5590191262dSYatharth Kochar @echo 5600191262dSYatharth Kochar @echo "Built $@ successfully" 5610191262dSYatharth Kochar @echo 5620191262dSYatharth Kochar 56373c99d4eSJuan Castillofiptool: ${FIPTOOL} 56473c99d4eSJuan Castillofip: ${BUILD_PLAT}/${FIP_NAME} 5650191262dSYatharth Kocharfwu_fip: ${BUILD_PLAT}/${FWU_FIP_NAME} 56673c99d4eSJuan Castillo 56773c99d4eSJuan Castillo.PHONY: ${FIPTOOL} 56873c99d4eSJuan Castillo${FIPTOOL}: 56973c99d4eSJuan Castillo ${Q}${MAKE} --no-print-directory -C ${FIPTOOLPATH} 570f58ad36fSHarry Liebel 57135fab8c9SJoakim Bechcscope: 57235fab8c9SJoakim Bech @echo " CSCOPE" 57335fab8c9SJoakim Bech ${Q}find ${CURDIR} -name "*.[chsS]" > cscope.files 57435fab8c9SJoakim Bech ${Q}cscope -b -q -k 57535fab8c9SJoakim Bech 57672ee3314SRyan Harkinhelp: 577c04d2606SDan Handley @echo "usage: ${MAKE} PLAT=<${PLATFORMS}> [OPTIONS] [TARGET]" 57872ee3314SRyan Harkin @echo "" 57972ee3314SRyan Harkin @echo "PLAT is used to specify which platform you wish to build." 58008c7ed0fSSandrine Bailleux @echo "If no platform is specified, PLAT defaults to: ${DEFAULT_PLAT}" 58172ee3314SRyan Harkin @echo "" 5821b578596SSandrine Bailleux @echo "Please refer to the User Guide for a list of all supported options." 5831b578596SSandrine Bailleux @echo "Note that the build system doesn't track dependencies for build " 5841b578596SSandrine Bailleux @echo "options. Therefore, if any of the build options are changed " 5851b578596SSandrine Bailleux @echo "from a previous build, a clean build must be performed." 5861b578596SSandrine Bailleux @echo "" 58772ee3314SRyan Harkin @echo "Supported Targets:" 5881b578596SSandrine Bailleux @echo " all Build all individual bootloader binaries" 58936eaaf37SIan Spray @echo " bl1 Build the BL1 binary" 5908aa559c0SJeenu Viswambharan @echo " bl2 Build the BL2 binary" 5919003fa0bSYatharth Kochar @echo " bl2u Build the BL2U binary" 592d178637dSJuan Castillo @echo " bl31 Build the BL31 binary" 593d178637dSJuan Castillo @echo " bl32 Build the BL32 binary" 59473c99d4eSJuan Castillo @echo " certificates Build the certificates (requires 'GENERATE_COT=1')" 5951b578596SSandrine Bailleux @echo " fip Build the Firmware Image Package (FIP)" 5960191262dSYatharth Kochar @echo " fwu_fip Build the FWU Firmware Image Package (FIP)" 59736eaaf37SIan Spray @echo " checkcodebase Check the coding style of the entire source tree" 59836eaaf37SIan Spray @echo " checkpatch Check the coding style on changes in the current" 59936eaaf37SIan Spray @echo " branch against BASE_COMMIT (default origin/master)" 60072ee3314SRyan Harkin @echo " clean Clean the build for the selected platform" 60135fab8c9SJoakim Bech @echo " cscope Generate cscope index" 60272ee3314SRyan Harkin @echo " distclean Remove all build artifacts for all platforms" 6036f971622SJuan Castillo @echo " certtool Build the Certificate generation tool" 604f58ad36fSHarry Liebel @echo " fiptool Build the Firmware Image Package(FIP) creation tool" 60572ee3314SRyan Harkin @echo "" 6061b578596SSandrine Bailleux @echo "Note: most build targets require PLAT to be set to a specific platform." 60772ee3314SRyan Harkin @echo "" 60872ee3314SRyan Harkin @echo "example: build all targets for the FVP platform:" 60972ee3314SRyan Harkin @echo " CROSS_COMPILE=aarch64-none-elf- make PLAT=fvp all" 610