xref: /rk3399_ARM-atf/Makefile (revision 8f0617ef9e469e47f6df077f2bb02e594594d3a7)
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