173c99d4eSJuan Castillo# 22d51b55eSBalint Dobszay# Copyright (c) 2015-2020, ARM Limited and Contributors. All rights reserved. 373c99d4eSJuan Castillo# 482cb2c1aSdp-arm# SPDX-License-Identifier: BSD-3-Clause 573c99d4eSJuan Castillo# 673c99d4eSJuan Castillo 71670d9dfSEvan Lloyd# Report an error if the eval make function is not available. 81670d9dfSEvan Lloyd$(eval eval_available := T) 91670d9dfSEvan Lloydifneq (${eval_available},T) 101670d9dfSEvan Lloyd $(error This makefile only works with a Make program that supports $$(eval)) 111670d9dfSEvan Lloydendif 121670d9dfSEvan Lloyd 13231c1470SEvan Lloyd# Some utility macros for manipulating awkward (whitespace) characters. 14231c1470SEvan Lloydblank := 15231c1470SEvan Lloydspace :=${blank} ${blank} 16231c1470SEvan Lloyd 17231c1470SEvan Lloyd# A user defined function to recursively search for a filename below a directory 18231c1470SEvan Lloyd# $1 is the directory root of the recursive search (blank for current directory). 19231c1470SEvan Lloyd# $2 is the file name to search for. 20231c1470SEvan Lloyddefine rwildcard 21231c1470SEvan Lloyd$(strip $(foreach d,$(wildcard ${1}*),$(call rwildcard,${d}/,${2}) $(filter $(subst *,%,%${2}),${d}))) 22231c1470SEvan Lloydendef 23231c1470SEvan Lloyd 245ba8f669SYatharth Kochar# This table is used in converting lower case to upper case. 255ba8f669SYatharth Kocharuppercase_table:=a,A b,B c,C d,D e,E f,F g,G h,H i,I j,J k,K l,L m,M n,N o,O p,P q,Q r,R s,S t,T u,U v,V w,W x,X y,Y z,Z 265ba8f669SYatharth Kochar 275ba8f669SYatharth Kochar# Internal macro used for converting lower case to upper case. 285ba8f669SYatharth Kochar# $(1) = upper case table 295ba8f669SYatharth Kochar# $(2) = String to convert 305ba8f669SYatharth Kochardefine uppercase_internal 315ba8f669SYatharth Kochar$(if $(1),$$(subst $(firstword $(1)),$(call uppercase_internal,$(wordlist 2,$(words $(1)),$(1)),$(2))),$(2)) 325ba8f669SYatharth Kocharendef 335ba8f669SYatharth Kochar 345ba8f669SYatharth Kochar# A macro for converting a string to upper case 355ba8f669SYatharth Kochar# $(1) = String to convert 365ba8f669SYatharth Kochardefine uppercase 375ba8f669SYatharth Kochar$(eval uppercase_result:=$(call uppercase_internal,$(uppercase_table),$(1)))$(uppercase_result) 385ba8f669SYatharth Kocharendef 395ba8f669SYatharth Kochar 4073c99d4eSJuan Castillo# Convenience function for adding build definitions 4173c99d4eSJuan Castillo# $(eval $(call add_define,FOO)) will have: 4273c99d4eSJuan Castillo# -DFOO if $(FOO) is empty; -DFOO=$(FOO) otherwise 4373c99d4eSJuan Castillodefine add_define 4473c99d4eSJuan Castillo DEFINES += -D$(1)$(if $(value $(1)),=$(value $(1)),) 4573c99d4eSJuan Castilloendef 4673c99d4eSJuan Castillo 478eadeb4aSSoren Brinkmann# Convenience function for adding build definitions 488eadeb4aSSoren Brinkmann# $(eval $(call add_define_val,FOO,BAR)) will have: 498eadeb4aSSoren Brinkmann# -DFOO=BAR 508eadeb4aSSoren Brinkmanndefine add_define_val 518eadeb4aSSoren Brinkmann DEFINES += -D$(1)=$(2) 528eadeb4aSSoren Brinkmannendef 538eadeb4aSSoren Brinkmann 5473c99d4eSJuan Castillo# Convenience function for verifying option has a boolean value 5573c99d4eSJuan Castillo# $(eval $(call assert_boolean,FOO)) will assert FOO is 0 or 1 5673c99d4eSJuan Castillodefine assert_boolean 57be4cd40eSMasahiro Yamada $(if $(filter-out 0 1,$($1)),$(error $1 must be boolean)) 5873c99d4eSJuan Castilloendef 5973c99d4eSJuan Castillo 60c877b414SJeenu Viswambharan0-9 := 0 1 2 3 4 5 6 7 8 9 61c877b414SJeenu Viswambharan 62c877b414SJeenu Viswambharan# Function to verify that a given option $(1) contains a numeric value 63c877b414SJeenu Viswambharandefine assert_numeric 64c877b414SJeenu Viswambharan$(if $($(1)),,$(error $(1) must not be empty)) 65c877b414SJeenu Viswambharan$(eval __numeric := $($(1))) 66c877b414SJeenu Viswambharan$(foreach d,$(0-9),$(eval __numeric := $(subst $(d),,$(__numeric)))) 67c877b414SJeenu Viswambharan$(if $(__numeric),$(error $(1) must be numeric)) 68c877b414SJeenu Viswambharanendef 69c877b414SJeenu Viswambharan 7073c99d4eSJuan Castillo# IMG_LINKERFILE defines the linker script corresponding to a BL stage 7173c99d4eSJuan Castillo# $(1) = BL stage (2, 30, 31, 32, 33) 7273c99d4eSJuan Castillodefine IMG_LINKERFILE 7373c99d4eSJuan Castillo ${BUILD_DIR}/bl$(1).ld 7473c99d4eSJuan Castilloendef 7573c99d4eSJuan Castillo 7673c99d4eSJuan Castillo# IMG_MAPFILE defines the output file describing the memory map corresponding 7773c99d4eSJuan Castillo# to a BL stage 7873c99d4eSJuan Castillo# $(1) = BL stage (2, 30, 31, 32, 33) 7973c99d4eSJuan Castillodefine IMG_MAPFILE 8073c99d4eSJuan Castillo ${BUILD_DIR}/bl$(1).map 8173c99d4eSJuan Castilloendef 8273c99d4eSJuan Castillo 8373c99d4eSJuan Castillo# IMG_ELF defines the elf file corresponding to a BL stage 8473c99d4eSJuan Castillo# $(1) = BL stage (2, 30, 31, 32, 33) 8573c99d4eSJuan Castillodefine IMG_ELF 8673c99d4eSJuan Castillo ${BUILD_DIR}/bl$(1).elf 8773c99d4eSJuan Castilloendef 8873c99d4eSJuan Castillo 8973c99d4eSJuan Castillo# IMG_DUMP defines the symbols dump file corresponding to a BL stage 9073c99d4eSJuan Castillo# $(1) = BL stage (2, 30, 31, 32, 33) 9173c99d4eSJuan Castillodefine IMG_DUMP 9273c99d4eSJuan Castillo ${BUILD_DIR}/bl$(1).dump 9373c99d4eSJuan Castilloendef 9473c99d4eSJuan Castillo 9573c99d4eSJuan Castillo# IMG_BIN defines the default image file corresponding to a BL stage 9673c99d4eSJuan Castillo# $(1) = BL stage (2, 30, 31, 32, 33) 9773c99d4eSJuan Castillodefine IMG_BIN 9873c99d4eSJuan Castillo ${BUILD_PLAT}/bl$(1).bin 9973c99d4eSJuan Castilloendef 10073c99d4eSJuan Castillo 10110cea934SMasahiro Yamada# TOOL_ADD_PAYLOAD appends the command line arguments required by fiptool to 10210cea934SMasahiro Yamada# package a new payload and/or by cert_create to generate certificate. 10310cea934SMasahiro Yamada# Optionally, it adds the dependency on this payload 10473c99d4eSJuan Castillo# $(1) = payload filename (i.e. bl31.bin) 1051e0c0784SMasahiro Yamada# $(2) = command line option for the specified payload (i.e. --soc-fw) 10636af3455SMasahiro Yamada# $(3) = tool target dependency (optional) (ex. build/fvp/release/bl31.bin) 1071dc0714fSMasahiro Yamada# $(4) = FIP prefix (optional) (if FWU_, target is fwu_fip instead of fip) 10810cea934SMasahiro Yamadadefine TOOL_ADD_PAYLOAD 109945b316fSMasahiro Yamada $(4)FIP_ARGS += $(2) $(1) 110945b316fSMasahiro Yamada $(if $(3),$(4)FIP_DEPS += $(3)) 111f30ee0b9SMasahiro Yamada $(4)CRT_ARGS += $(2) $(1) 112f30ee0b9SMasahiro Yamada $(if $(3),$(4)CRT_DEPS += $(3)) 11373c99d4eSJuan Castilloendef 11473c99d4eSJuan Castillo 1152da522bbSMasahiro Yamada# TOOL_ADD_IMG_PAYLOAD works like TOOL_ADD_PAYLOAD, but applies image filters 1162da522bbSMasahiro Yamada# before passing them to host tools if BL*_PRE_TOOL_FILTER is defined. 1172da522bbSMasahiro Yamada# $(1) = image_type (scp_bl2, bl33, etc.) 1182da522bbSMasahiro Yamada# $(2) = payload filepath (ex. build/fvp/release/bl31.bin) 1192da522bbSMasahiro Yamada# $(3) = command line option for the specified payload (ex. --soc-fw) 1202da522bbSMasahiro Yamada# $(4) = tool target dependency (optional) (ex. build/fvp/release/bl31.bin) 1212da522bbSMasahiro Yamada# $(5) = FIP prefix (optional) (if FWU_, target is fwu_fip instead of fip) 1222da522bbSMasahiro Yamada 1232da522bbSMasahiro Yamadadefine TOOL_ADD_IMG_PAYLOAD 1242da522bbSMasahiro Yamada 1252da522bbSMasahiro Yamada$(eval PRE_TOOL_FILTER := $($(call uppercase,$(1))_PRE_TOOL_FILTER)) 1262da522bbSMasahiro Yamada 1272da522bbSMasahiro Yamadaifneq ($(PRE_TOOL_FILTER),) 1282da522bbSMasahiro Yamada 1292da522bbSMasahiro Yamada$(eval PROCESSED_PATH := $(BUILD_PLAT)/$(1).bin$($(PRE_TOOL_FILTER)_SUFFIX)) 1302da522bbSMasahiro Yamada 1312da522bbSMasahiro Yamada$(call $(PRE_TOOL_FILTER)_RULE,$(PROCESSED_PATH),$(2)) 1322da522bbSMasahiro Yamada 1332da522bbSMasahiro Yamada$(PROCESSED_PATH): $(4) 1342da522bbSMasahiro Yamada 1352da522bbSMasahiro Yamada$(call TOOL_ADD_PAYLOAD,$(PROCESSED_PATH),$(3),$(PROCESSED_PATH),$(5)) 1362da522bbSMasahiro Yamada 1372da522bbSMasahiro Yamadaelse 1382da522bbSMasahiro Yamada$(call TOOL_ADD_PAYLOAD,$(2),$(3),$(4),$(5)) 1392da522bbSMasahiro Yamadaendif 1402da522bbSMasahiro Yamadaendef 1412da522bbSMasahiro Yamada 1420191262dSYatharth Kochar# CERT_ADD_CMD_OPT adds a new command line option to the cert_create invocation 14373c99d4eSJuan Castillo# $(1) = parameter filename 14473c99d4eSJuan Castillo# $(2) = cert_create command line option for the specified parameter 14591704d9dSMasahiro Yamada# $(3) = FIP prefix (optional) (if FWU_, target is fwu_fip instead of fip) 14673c99d4eSJuan Castillodefine CERT_ADD_CMD_OPT 14791704d9dSMasahiro Yamada $(3)CRT_ARGS += $(2) $(1) 14873c99d4eSJuan Castilloendef 14973c99d4eSJuan Castillo 150c939d13aSMasahiro Yamada# TOOL_ADD_IMG allows the platform to specify an external image to be packed 151c939d13aSMasahiro Yamada# in the FIP and/or for which certificate is generated. It also adds a 152c939d13aSMasahiro Yamada# dependency on the image file, aborting the build if the file does not exist. 15333950dd8SMasahiro Yamada# $(1) = image_type (scp_bl2, bl33, etc.) 1541e0c0784SMasahiro Yamada# $(2) = command line option for fiptool (--scp-fw, --nt-fw, etc) 1551dc0714fSMasahiro Yamada# $(3) = FIP prefix (optional) (if FWU_, target is fwu_fip instead of fip) 15673c99d4eSJuan Castillo# Example: 15733950dd8SMasahiro Yamada# $(eval $(call TOOL_ADD_IMG,bl33,--nt-fw)) 158c939d13aSMasahiro Yamadadefine TOOL_ADD_IMG 15933950dd8SMasahiro Yamada # Build option to specify the image filename (SCP_BL2, BL33, etc) 16033950dd8SMasahiro Yamada # This is the uppercase form of the first parameter 16133950dd8SMasahiro Yamada $(eval _V := $(call uppercase,$(1))) 16233950dd8SMasahiro Yamada 163945b316fSMasahiro Yamada $(3)CRT_DEPS += check_$(1) 164945b316fSMasahiro Yamada $(3)FIP_DEPS += check_$(1) 1652da522bbSMasahiro Yamada $(call TOOL_ADD_IMG_PAYLOAD,$(1),$(value $(_V)),$(2),,$(3)) 1660191262dSYatharth Kochar 16787ebd20dSMasahiro Yamada.PHONY: check_$(1) 1680191262dSYatharth Kocharcheck_$(1): 16933950dd8SMasahiro Yamada $$(if $(value $(_V)),,$$(error "Platform '${PLAT}' requires $(_V). Please set $(_V) to point to the right file")) 17033950dd8SMasahiro Yamada $$(if $(wildcard $(value $(_V))),,$$(error '$(_V)=$(value $(_V))' was specified, but '$(value $(_V))' does not exist)) 1710191262dSYatharth Kocharendef 17273c99d4eSJuan Castillo 17373c99d4eSJuan Castillo################################################################################ 17414db8908SMasahiro Yamada# Generic image processing filters 17514db8908SMasahiro Yamada################################################################################ 17614db8908SMasahiro Yamada 17714db8908SMasahiro Yamada# GZIP 17814db8908SMasahiro Yamadadefine GZIP_RULE 17914db8908SMasahiro Yamada$(1): $(2) 180ee1ba6d4SAndre Przywara $(ECHO) " GZIP $$@" 18114db8908SMasahiro Yamada $(Q)gzip -n -f -9 $$< --stdout > $$@ 18214db8908SMasahiro Yamadaendef 18314db8908SMasahiro Yamada 18414db8908SMasahiro YamadaGZIP_SUFFIX := .gz 18514db8908SMasahiro Yamada 18614db8908SMasahiro Yamada################################################################################ 18773c99d4eSJuan Castillo# Auxiliary macros to build TF images from sources 18873c99d4eSJuan Castillo################################################################################ 18973c99d4eSJuan Castillo 1901d274ab0SMasahiro YamadaMAKE_DEP = -Wp,-MD,$(DEP) -MT $$@ -MP 19173c99d4eSJuan Castillo 1925fee0287SRoberto Vargas 1935fee0287SRoberto Vargas# MAKE_C_LIB builds a C source file and generates the dependency file 1945fee0287SRoberto Vargas# $(1) = output directory 1955fee0287SRoberto Vargas# $(2) = source file (%.c) 1965fee0287SRoberto Vargas# $(3) = library name 1975fee0287SRoberto Vargasdefine MAKE_C_LIB 1985fee0287SRoberto Vargas$(eval OBJ := $(1)/$(patsubst %.c,%.o,$(notdir $(2)))) 1995fee0287SRoberto Vargas$(eval DEP := $(patsubst %.o,%.d,$(OBJ))) 2005fee0287SRoberto Vargas 2015fee0287SRoberto Vargas$(OBJ): $(2) $(filter-out %.d,$(MAKEFILE_LIST)) | lib$(3)_dirs 202ee1ba6d4SAndre Przywara $$(ECHO) " CC $$<" 2035fee0287SRoberto Vargas $$(Q)$$(CC) $$(TF_CFLAGS) $$(CFLAGS) $(MAKE_DEP) -c $$< -o $$@ 2045fee0287SRoberto Vargas 2055fee0287SRoberto Vargas-include $(DEP) 2065fee0287SRoberto Vargas 2075fee0287SRoberto Vargasendef 2085fee0287SRoberto Vargas 20970b0f278SAntonio Nino Diaz# MAKE_S_LIB builds an assembly source file and generates the dependency file 21070b0f278SAntonio Nino Diaz# $(1) = output directory 21170b0f278SAntonio Nino Diaz# $(2) = source file (%.S) 21270b0f278SAntonio Nino Diaz# $(3) = library name 21370b0f278SAntonio Nino Diazdefine MAKE_S_LIB 21470b0f278SAntonio Nino Diaz$(eval OBJ := $(1)/$(patsubst %.S,%.o,$(notdir $(2)))) 21570b0f278SAntonio Nino Diaz$(eval DEP := $(patsubst %.o,%.d,$(OBJ))) 21670b0f278SAntonio Nino Diaz 21770b0f278SAntonio Nino Diaz$(OBJ): $(2) $(filter-out %.d,$(MAKEFILE_LIST)) | lib$(3)_dirs 21870b0f278SAntonio Nino Diaz $$(ECHO) " AS $$<" 21970b0f278SAntonio Nino Diaz $$(Q)$$(AS) $$(ASFLAGS) $(MAKE_DEP) -c $$< -o $$@ 22070b0f278SAntonio Nino Diaz 22170b0f278SAntonio Nino Diaz-include $(DEP) 22270b0f278SAntonio Nino Diaz 22370b0f278SAntonio Nino Diazendef 22470b0f278SAntonio Nino Diaz 2255fee0287SRoberto Vargas 22673c99d4eSJuan Castillo# MAKE_C builds a C source file and generates the dependency file 22773c99d4eSJuan Castillo# $(1) = output directory 22873c99d4eSJuan Castillo# $(2) = source file (%.c) 2295ba8f669SYatharth Kochar# $(3) = BL stage (2, 2u, 30, 31, 32, 33) 23073c99d4eSJuan Castillodefine MAKE_C 23173c99d4eSJuan Castillo 23273c99d4eSJuan Castillo$(eval OBJ := $(1)/$(patsubst %.c,%.o,$(notdir $(2)))) 233710ea1d0SMasahiro Yamada$(eval DEP := $(patsubst %.o,%.d,$(OBJ))) 2345ba8f669SYatharth Kochar$(eval IMAGE := IMAGE_BL$(call uppercase,$(3))) 2353661f16cSJeenu Viswambharan$(eval BL_CFLAGS := $(BL$(call uppercase,$(3))_CFLAGS)) 23673c99d4eSJuan Castillo 2376bc1a30cSStephen Warren$(OBJ): $(2) $(filter-out %.d,$(MAKEFILE_LIST)) | bl$(3)_dirs 238ee1ba6d4SAndre Przywara $$(ECHO) " CC $$<" 239edbce9aaSzelalem-aweke $$(Q)$$(CC) $$(LTO_CFLAGS) $$(TF_CFLAGS) $$(CFLAGS) $(BL_CFLAGS) -D$(IMAGE) $(MAKE_DEP) -c $$< -o $$@ 24073c99d4eSJuan Castillo 241710ea1d0SMasahiro Yamada-include $(DEP) 24273c99d4eSJuan Castillo 24373c99d4eSJuan Castilloendef 24473c99d4eSJuan Castillo 24573c99d4eSJuan Castillo 24673c99d4eSJuan Castillo# MAKE_S builds an assembly source file and generates the dependency file 24773c99d4eSJuan Castillo# $(1) = output directory 24873c99d4eSJuan Castillo# $(2) = assembly file (%.S) 2495ba8f669SYatharth Kochar# $(3) = BL stage (2, 2u, 30, 31, 32, 33) 25073c99d4eSJuan Castillodefine MAKE_S 25173c99d4eSJuan Castillo 25273c99d4eSJuan Castillo$(eval OBJ := $(1)/$(patsubst %.S,%.o,$(notdir $(2)))) 253710ea1d0SMasahiro Yamada$(eval DEP := $(patsubst %.o,%.d,$(OBJ))) 2545ba8f669SYatharth Kochar$(eval IMAGE := IMAGE_BL$(call uppercase,$(3))) 25573c99d4eSJuan Castillo 2566bc1a30cSStephen Warren$(OBJ): $(2) $(filter-out %.d,$(MAKEFILE_LIST)) | bl$(3)_dirs 257ee1ba6d4SAndre Przywara $$(ECHO) " AS $$<" 258710ea1d0SMasahiro Yamada $$(Q)$$(AS) $$(ASFLAGS) -D$(IMAGE) $(MAKE_DEP) -c $$< -o $$@ 25973c99d4eSJuan Castillo 260710ea1d0SMasahiro Yamada-include $(DEP) 26173c99d4eSJuan Castillo 26273c99d4eSJuan Castilloendef 26373c99d4eSJuan Castillo 26473c99d4eSJuan Castillo 26573c99d4eSJuan Castillo# MAKE_LD generate the linker script using the C preprocessor 26673c99d4eSJuan Castillo# $(1) = output linker script 26773c99d4eSJuan Castillo# $(2) = input template 268a6ca7888SMasahiro Yamada# $(3) = BL stage (2, 2u, 30, 31, 32, 33) 26973c99d4eSJuan Castillodefine MAKE_LD 27073c99d4eSJuan Castillo 271710ea1d0SMasahiro Yamada$(eval DEP := $(1).d) 2721a4b46d5SDaniel Boulby$(eval IMAGE := IMAGE_BL$(call uppercase,$(3))) 27373c99d4eSJuan Castillo 2746bc1a30cSStephen Warren$(1): $(2) $(filter-out %.d,$(MAKEFILE_LIST)) | bl$(3)_dirs 275ee1ba6d4SAndre Przywara $$(ECHO) " PP $$<" 276402b3cf8SJulius Werner $$(Q)$$(CPP) $$(CPPFLAGS) $(TF_CFLAGS_$(ARCH)) -P -x assembler-with-cpp -D__LINKER__ $(MAKE_DEP) -D$(IMAGE) -o $$@ $$< 27773c99d4eSJuan Castillo 278710ea1d0SMasahiro Yamada-include $(DEP) 27973c99d4eSJuan Castillo 28073c99d4eSJuan Castilloendef 28173c99d4eSJuan Castillo 28270b0f278SAntonio Nino Diaz# MAKE_LIB_OBJS builds both C and assembly source files 2835fee0287SRoberto Vargas# $(1) = output directory 2845fee0287SRoberto Vargas# $(2) = list of source files 2855fee0287SRoberto Vargas# $(3) = name of the library 2865fee0287SRoberto Vargasdefine MAKE_LIB_OBJS 2875fee0287SRoberto Vargas $(eval C_OBJS := $(filter %.c,$(2))) 2885fee0287SRoberto Vargas $(eval REMAIN := $(filter-out %.c,$(2))) 2895fee0287SRoberto Vargas $(eval $(foreach obj,$(C_OBJS),$(call MAKE_C_LIB,$(1),$(obj),$(3)))) 2905fee0287SRoberto Vargas 29170b0f278SAntonio Nino Diaz $(eval S_OBJS := $(filter %.S,$(REMAIN))) 29270b0f278SAntonio Nino Diaz $(eval REMAIN := $(filter-out %.S,$(REMAIN))) 29370b0f278SAntonio Nino Diaz $(eval $(foreach obj,$(S_OBJS),$(call MAKE_S_LIB,$(1),$(obj),$(3)))) 29470b0f278SAntonio Nino Diaz 2955fee0287SRoberto Vargas $(and $(REMAIN),$(error Unexpected source files present: $(REMAIN))) 2965fee0287SRoberto Vargasendef 2975fee0287SRoberto Vargas 29873c99d4eSJuan Castillo 29973c99d4eSJuan Castillo# MAKE_OBJS builds both C and assembly source files 30073c99d4eSJuan Castillo# $(1) = output directory 30173c99d4eSJuan Castillo# $(2) = list of source files (both C and assembly) 30273c99d4eSJuan Castillo# $(3) = BL stage (2, 30, 31, 32, 33) 30373c99d4eSJuan Castillodefine MAKE_OBJS 30473c99d4eSJuan Castillo $(eval C_OBJS := $(filter %.c,$(2))) 30573c99d4eSJuan Castillo $(eval REMAIN := $(filter-out %.c,$(2))) 30673c99d4eSJuan Castillo $(eval $(foreach obj,$(C_OBJS),$(call MAKE_C,$(1),$(obj),$(3)))) 30773c99d4eSJuan Castillo 30873c99d4eSJuan Castillo $(eval S_OBJS := $(filter %.S,$(REMAIN))) 30973c99d4eSJuan Castillo $(eval REMAIN := $(filter-out %.S,$(REMAIN))) 31073c99d4eSJuan Castillo $(eval $(foreach obj,$(S_OBJS),$(call MAKE_S,$(1),$(obj),$(3)))) 31173c99d4eSJuan Castillo 31273c99d4eSJuan Castillo $(and $(REMAIN),$(error Unexpected source files present: $(REMAIN))) 31373c99d4eSJuan Castilloendef 31473c99d4eSJuan Castillo 31573c99d4eSJuan Castillo 31673c99d4eSJuan Castillo# NOTE: The line continuation '\' is required in the next define otherwise we 31773c99d4eSJuan Castillo# end up with a line-feed characer at the end of the last c filename. 318e7f54dbdSEvan Lloyd# Also bear this issue in mind if extending the list of supported filetypes. 31973c99d4eSJuan Castillodefine SOURCES_TO_OBJS 32073c99d4eSJuan Castillo $(notdir $(patsubst %.c,%.o,$(filter %.c,$(1)))) \ 32173c99d4eSJuan Castillo $(notdir $(patsubst %.S,%.o,$(filter %.S,$(1)))) 32273c99d4eSJuan Castilloendef 32373c99d4eSJuan Castillo 3242f5d4a48SPatrick Georgi# Allow overriding the timestamp, for example for reproducible builds, or to 3252f5d4a48SPatrick Georgi# synchronize timestamps across multiple projects. 3262f5d4a48SPatrick Georgi# This must be set to a C string (including quotes where applicable). 3272f5d4a48SPatrick GeorgiBUILD_MESSAGE_TIMESTAMP ?= __TIME__", "__DATE__ 32873c99d4eSJuan Castillo 3295fee0287SRoberto Vargas.PHONY: libraries 3305fee0287SRoberto Vargas 3315accce5bSRoberto Vargas# MAKE_LIB_DIRS macro defines the target for the directory where 3325fee0287SRoberto Vargas# libraries are created 3335accce5bSRoberto Vargasdefine MAKE_LIB_DIRS 3345fee0287SRoberto Vargas $(eval LIB_DIR := ${BUILD_PLAT}/lib) 3355accce5bSRoberto Vargas $(eval ROMLIB_DIR := ${BUILD_PLAT}/romlib) 3365accce5bSRoberto Vargas $(eval LIBWRAPPER_DIR := ${BUILD_PLAT}/libwrapper) 3375fee0287SRoberto Vargas $(eval $(call MAKE_PREREQ_DIR,${LIB_DIR},${BUILD_PLAT})) 3385accce5bSRoberto Vargas $(eval $(call MAKE_PREREQ_DIR,${ROMLIB_DIR},${BUILD_PLAT})) 3395accce5bSRoberto Vargas $(eval $(call MAKE_PREREQ_DIR,${LIBWRAPPER_DIR},${BUILD_PLAT})) 3405fee0287SRoberto Vargasendef 3415fee0287SRoberto Vargas 3425fee0287SRoberto Vargas# MAKE_LIB macro defines the targets and options to build each BL image. 3435fee0287SRoberto Vargas# Arguments: 3445fee0287SRoberto Vargas# $(1) = Library name 3455fee0287SRoberto Vargasdefine MAKE_LIB 3465fee0287SRoberto Vargas $(eval BUILD_DIR := ${BUILD_PLAT}/lib$(1)) 3475fee0287SRoberto Vargas $(eval LIB_DIR := ${BUILD_PLAT}/lib) 3485accce5bSRoberto Vargas $(eval ROMLIB_DIR := ${BUILD_PLAT}/romlib) 3495fee0287SRoberto Vargas $(eval SOURCES := $(LIB$(call uppercase,$(1))_SRCS)) 3505fee0287SRoberto Vargas $(eval OBJS := $(addprefix $(BUILD_DIR)/,$(call SOURCES_TO_OBJS,$(SOURCES)))) 3515fee0287SRoberto Vargas 3525fee0287SRoberto Vargas$(eval $(call MAKE_PREREQ_DIR,${BUILD_DIR},${BUILD_PLAT})) 3535fee0287SRoberto Vargas$(eval $(call MAKE_LIB_OBJS,$(BUILD_DIR),$(SOURCES),$(1))) 3545fee0287SRoberto Vargas 3555fee0287SRoberto Vargas.PHONY : lib${1}_dirs 3565accce5bSRoberto Vargaslib${1}_dirs: | ${BUILD_DIR} ${LIB_DIR} ${ROMLIB_DIR} ${LIBWRAPPER_DIR} 3575fee0287SRoberto Vargaslibraries: ${LIB_DIR}/lib$(1).a 358c2ad38ceSVarun Wadekarifneq ($(findstring armlink,$(notdir $(LD))),) 359c2ad38ceSVarun WadekarLDPATHS = --userlibpath=${LIB_DIR} 360c2ad38ceSVarun WadekarLDLIBS += --library=$(1) 361c2ad38ceSVarun Wadekarelse 3625fee0287SRoberto VargasLDPATHS = -L${LIB_DIR} 3635fee0287SRoberto VargasLDLIBS += -l$(1) 364c2ad38ceSVarun Wadekarendif 3655fee0287SRoberto Vargas 3665accce5bSRoberto Vargasifeq ($(USE_ROMLIB),1) 3676baf85b3SSathees BalyaLIBWRAPPER = -lwrappers 3685accce5bSRoberto Vargasendif 3695accce5bSRoberto Vargas 3705fee0287SRoberto Vargasall: ${LIB_DIR}/lib$(1).a 3715fee0287SRoberto Vargas 3725fee0287SRoberto Vargas${LIB_DIR}/lib$(1).a: $(OBJS) 373ee1ba6d4SAndre Przywara $$(ECHO) " AR $$@" 3745fee0287SRoberto Vargas $$(Q)$$(AR) cr $$@ $$? 3755fee0287SRoberto Vargasendef 3765fee0287SRoberto Vargas 37773c99d4eSJuan Castillo# MAKE_BL macro defines the targets and options to build each BL image. 37873c99d4eSJuan Castillo# Arguments: 3795ba8f669SYatharth Kochar# $(1) = BL stage (2, 2u, 30, 31, 32, 33) 3808f0617efSJuan Castillo# $(2) = FIP command line option (if empty, image will not be included in the FIP) 3811dc0714fSMasahiro Yamada# $(3) = FIP prefix (optional) (if FWU_, target is fwu_fip instead of fip) 38273c99d4eSJuan Castillodefine MAKE_BL 38373c99d4eSJuan Castillo $(eval BUILD_DIR := ${BUILD_PLAT}/bl$(1)) 3845ba8f669SYatharth Kochar $(eval BL_SOURCES := $(BL$(call uppercase,$(1))_SOURCES)) 3855ba8f669SYatharth Kochar $(eval SOURCES := $(BL_SOURCES) $(BL_COMMON_SOURCES) $(PLAT_BL_COMMON_SOURCES)) 38673c99d4eSJuan Castillo $(eval OBJS := $(addprefix $(BUILD_DIR)/,$(call SOURCES_TO_OBJS,$(SOURCES)))) 38773c99d4eSJuan Castillo $(eval LINKERFILE := $(call IMG_LINKERFILE,$(1))) 38873c99d4eSJuan Castillo $(eval MAPFILE := $(call IMG_MAPFILE,$(1))) 38973c99d4eSJuan Castillo $(eval ELF := $(call IMG_ELF,$(1))) 39073c99d4eSJuan Castillo $(eval DUMP := $(call IMG_DUMP,$(1))) 39173c99d4eSJuan Castillo $(eval BIN := $(call IMG_BIN,$(1))) 3925ba8f669SYatharth Kochar $(eval BL_LINKERFILE := $(BL$(call uppercase,$(1))_LINKERFILE)) 39323e0fe52SKonstantin Porotchkin $(eval BL_LIBS := $(BL$(call uppercase,$(1))_LIBS)) 39451b27702SEvan Lloyd # We use sort only to get a list of unique object directory names. 39551b27702SEvan Lloyd # ordering is not relevant but sort removes duplicates. 3966ba7d274SEvan Lloyd $(eval TEMP_OBJ_DIRS := $(sort $(dir ${OBJS} ${LINKERFILE}))) 39751b27702SEvan Lloyd # The $(dir ) function leaves a trailing / on the directory names 398d014ea6cSMasahiro Yamada # Rip off the / to match directory names with make rule targets. 399d014ea6cSMasahiro Yamada $(eval OBJ_DIRS := $(patsubst %/,%,$(TEMP_OBJ_DIRS))) 40051b27702SEvan Lloyd 40151b27702SEvan Lloyd# Create generators for object directory structure 40251b27702SEvan Lloyd 4038012cc5cSMasahiro Yamada$(eval $(call MAKE_PREREQ_DIR,${BUILD_DIR},${BUILD_PLAT})) 4046ba7d274SEvan Lloyd 4056ba7d274SEvan Lloyd$(eval $(foreach objd,${OBJ_DIRS},$(call MAKE_PREREQ_DIR,${objd},${BUILD_DIR}))) 40651b27702SEvan Lloyd 40751b27702SEvan Lloyd.PHONY : bl${1}_dirs 40851b27702SEvan Lloyd 40951b27702SEvan Lloyd# We use order-only prerequisites to ensure that directories are created, 41051b27702SEvan Lloyd# but do not cause re-builds every time a file is written. 41151b27702SEvan Lloydbl${1}_dirs: | ${OBJ_DIRS} 41273c99d4eSJuan Castillo 41373c99d4eSJuan Castillo$(eval $(call MAKE_OBJS,$(BUILD_DIR),$(SOURCES),$(1))) 414a6ca7888SMasahiro Yamada$(eval $(call MAKE_LD,$(LINKERFILE),$(BL_LINKERFILE),$(1))) 415*d986bae4SMasahiro Yamada$(eval BL_LDFLAGS := $(BL$(call uppercase,$(1))_LDFLAGS)) 41673c99d4eSJuan Castillo 4175accce5bSRoberto Vargasifeq ($(USE_ROMLIB),1) 4185accce5bSRoberto Vargas$(ELF): romlib.bin 4195accce5bSRoberto Vargasendif 4205accce5bSRoberto Vargas 4215fee0287SRoberto Vargas$(ELF): $(OBJS) $(LINKERFILE) | bl$(1)_dirs libraries $(BL_LIBS) 422ee1ba6d4SAndre Przywara $$(ECHO) " LD $$@" 423414ab853SEvan Lloydifdef MAKE_BUILD_STRINGS 424414ab853SEvan Lloyd $(call MAKE_BUILD_STRINGS, $(BUILD_DIR)/build_message.o) 425414ab853SEvan Lloydelse 4262f5d4a48SPatrick Georgi @echo 'const char build_message[] = "Built : "$(BUILD_MESSAGE_TIMESTAMP); \ 42773c99d4eSJuan Castillo const char version_string[] = "${VERSION_STRING}";' | \ 428f2e1d57eSMasahiro Yamada $$(CC) $$(TF_CFLAGS) $$(CFLAGS) -xc -c - -o $(BUILD_DIR)/build_message.o 429414ab853SEvan Lloydendif 430c2ad38ceSVarun Wadekarifneq ($(findstring armlink,$(notdir $(LD))),) 431*d986bae4SMasahiro Yamada $$(Q)$$(LD) -o $$@ $$(TF_LDFLAGS) $$(LDFLAGS) $(BL_LDFLAGS) --entry=bl${1}_entrypoint \ 432c2ad38ceSVarun Wadekar --predefine="-D__LINKER__=$(__LINKER__)" \ 433c2ad38ceSVarun Wadekar --predefine="-DTF_CFLAGS=$(TF_CFLAGS)" \ 434c2ad38ceSVarun Wadekar --map --list="$(MAPFILE)" --scatter=${PLAT_DIR}/scat/bl${1}.scat \ 435c2ad38ceSVarun Wadekar $(LDPATHS) $(LIBWRAPPER) $(LDLIBS) $(BL_LIBS) \ 436c2ad38ceSVarun Wadekar $(BUILD_DIR)/build_message.o $(OBJS) 437edbce9aaSzelalem-awekeelse ifneq ($(findstring gcc,$(notdir $(LD))),) 438edbce9aaSzelalem-aweke $$(Q)$$(LD) -o $$@ $$(TF_LDFLAGS) $$(LDFLAGS) -Wl,-Map=$(MAPFILE) \ 439edbce9aaSzelalem-aweke -Wl,-T$(LINKERFILE) $(BUILD_DIR)/build_message.o \ 440edbce9aaSzelalem-aweke $(OBJS) $(LDPATHS) $(LIBWRAPPER) $(LDLIBS) $(BL_LIBS) 441c2ad38ceSVarun Wadekarelse 442*d986bae4SMasahiro Yamada $$(Q)$$(LD) -o $$@ $$(TF_LDFLAGS) $$(LDFLAGS) $(BL_LDFLAGS) -Map=$(MAPFILE) \ 4435fee0287SRoberto Vargas --script $(LINKERFILE) $(BUILD_DIR)/build_message.o \ 4446baf85b3SSathees Balya $(OBJS) $(LDPATHS) $(LIBWRAPPER) $(LDLIBS) $(BL_LIBS) 445c2ad38ceSVarun Wadekarendif 4469e4609f1SChristoph Müllnerifeq ($(DISABLE_BIN_GENERATION),1) 4479e4609f1SChristoph Müllner @${ECHO_BLANK_LINE} 4489e4609f1SChristoph Müllner @echo "Built $$@ successfully" 4499e4609f1SChristoph Müllner @${ECHO_BLANK_LINE} 4509e4609f1SChristoph Müllnerendif 45173c99d4eSJuan Castillo 45273c99d4eSJuan Castillo$(DUMP): $(ELF) 453ee1ba6d4SAndre Przywara $${ECHO} " OD $$@" 45473c99d4eSJuan Castillo $${Q}$${OD} -dx $$< > $$@ 45573c99d4eSJuan Castillo 45673c99d4eSJuan Castillo$(BIN): $(ELF) 457ee1ba6d4SAndre Przywara $${ECHO} " BIN $$@" 45873c99d4eSJuan Castillo $$(Q)$$(OC) -O binary $$< $$@ 459052ab529SEvan Lloyd @${ECHO_BLANK_LINE} 46073c99d4eSJuan Castillo @echo "Built $$@ successfully" 461052ab529SEvan Lloyd @${ECHO_BLANK_LINE} 46273c99d4eSJuan Castillo 46373c99d4eSJuan Castillo.PHONY: bl$(1) 4649e4609f1SChristoph Müllnerifeq ($(DISABLE_BIN_GENERATION),1) 4659e4609f1SChristoph Müllnerbl$(1): $(ELF) $(DUMP) 4669e4609f1SChristoph Müllnerelse 46751b27702SEvan Lloydbl$(1): $(BIN) $(DUMP) 4689e4609f1SChristoph Müllnerendif 46973c99d4eSJuan Castillo 47073c99d4eSJuan Castilloall: bl$(1) 47173c99d4eSJuan Castillo 4722da522bbSMasahiro Yamada$(if $(2),$(call TOOL_ADD_IMG_PAYLOAD,bl$(1),$(BIN),--$(2),$(BIN),$(3))) 47373c99d4eSJuan Castillo 47473c99d4eSJuan Castilloendef 47573c99d4eSJuan Castillo 47638c14d88SSoby Mathew# Convert device tree source file names to matching blobs 47738c14d88SSoby Mathew# $(1) = input dts 47803b397a8SNishanth Menondefine SOURCES_TO_DTBS 47903b397a8SNishanth Menon $(notdir $(patsubst %.dts,%.dtb,$(filter %.dts,$(1)))) 48003b397a8SNishanth Menonendef 48103b397a8SNishanth Menon 48238c14d88SSoby Mathew# MAKE_FDT_DIRS macro creates the prerequisite directories that host the 48338c14d88SSoby Mathew# FDT binaries 48438c14d88SSoby Mathew# $(1) = output directory 48538c14d88SSoby Mathew# $(2) = input dts 48638c14d88SSoby Mathewdefine MAKE_FDT_DIRS 48738c14d88SSoby Mathew $(eval DTBS := $(addprefix $(1)/,$(call SOURCES_TO_DTBS,$(2)))) 48803b397a8SNishanth Menon $(eval TEMP_DTB_DIRS := $(sort $(dir ${DTBS}))) 48903b397a8SNishanth Menon # The $(dir ) function leaves a trailing / on the directory names 49003b397a8SNishanth Menon # Rip off the / to match directory names with make rule targets. 49103b397a8SNishanth Menon $(eval DTB_DIRS := $(patsubst %/,%,$(TEMP_DTB_DIRS))) 49203b397a8SNishanth Menon 49303b397a8SNishanth Menon$(eval $(foreach objd,${DTB_DIRS},$(call MAKE_PREREQ_DIR,${objd},${BUILD_DIR}))) 49403b397a8SNishanth Menon 49503b397a8SNishanth Menonfdt_dirs: ${DTB_DIRS} 49603b397a8SNishanth Menonendef 49703b397a8SNishanth Menon 49838c14d88SSoby Mathew# MAKE_DTB generate the Flattened device tree binary 49903b397a8SNishanth Menon# $(1) = output directory 50003b397a8SNishanth Menon# $(2) = input dts 50103b397a8SNishanth Menondefine MAKE_DTB 50203b397a8SNishanth Menon 503077b3e9aSYann Gautier# List of DTB file(s) to generate, based on DTS file basename list 50438c14d88SSoby Mathew$(eval DOBJ := $(addprefix $(1)/,$(call SOURCES_TO_DTBS,$(2)))) 505077b3e9aSYann Gautier# List of the pre-compiled DTS file(s) 50601d237cbSYann Gautier$(eval DPRE := $(addprefix $(1)/,$(patsubst %.dts,%.pre.dts,$(notdir $(2))))) 507077b3e9aSYann Gautier# Dependencies of the pre-compiled DTS file(s) on its source and included files 508077b3e9aSYann Gautier$(eval DTSDEP := $(patsubst %.dtb,%.o.d,$(DOBJ))) 509077b3e9aSYann Gautier# Dependencies of the DT compilation on its pre-compiled DTS 510077b3e9aSYann Gautier$(eval DTBDEP := $(patsubst %.dtb,%.d,$(DOBJ))) 51103b397a8SNishanth Menon 5126bc1a30cSStephen Warren$(DOBJ): $(2) $(filter-out %.d,$(MAKEFILE_LIST)) | fdt_dirs 513ee1ba6d4SAndre Przywara $${ECHO} " CPP $$<" 514077b3e9aSYann Gautier $(eval DTBS := $(addprefix $(1)/,$(call SOURCES_TO_DTBS,$(2)))) 5157e94a699SManish Pandey $$(Q)$$(PP) $$(DTC_CPPFLAGS) -MT $(DTBS) -MMD -MF $(DTSDEP) -o $(DPRE) $$< 516ee1ba6d4SAndre Przywara $${ECHO} " DTC $$<" 5172d51b55eSBalint Dobszay $$(Q)$$(DTC) $$(DTC_FLAGS) -d $(DTBDEP) -o $$@ $(DPRE) 51803b397a8SNishanth Menon 519077b3e9aSYann Gautier-include $(DTBDEP) 520077b3e9aSYann Gautier-include $(DTSDEP) 52103b397a8SNishanth Menon 52203b397a8SNishanth Menonendef 52303b397a8SNishanth Menon 52403b397a8SNishanth Menon# MAKE_DTBS builds flattened device tree sources 52503b397a8SNishanth Menon# $(1) = output directory 52603b397a8SNishanth Menon# $(2) = list of flattened device tree source files 52703b397a8SNishanth Menondefine MAKE_DTBS 52803b397a8SNishanth Menon $(eval DOBJS := $(filter %.dts,$(2))) 52903b397a8SNishanth Menon $(eval REMAIN := $(filter-out %.dts,$(2))) 53038c14d88SSoby Mathew $(and $(REMAIN),$(error FDT_SOURCES contain non-DTS files: $(REMAIN))) 53103b397a8SNishanth Menon $(eval $(foreach obj,$(DOBJS),$(call MAKE_DTB,$(1),$(obj)))) 53203b397a8SNishanth Menon 53338c14d88SSoby Mathew $(eval $(call MAKE_FDT_DIRS,$(1),$(2))) 53438c14d88SSoby Mathew 53538c14d88SSoby Mathewdtbs: $(DTBS) 53638c14d88SSoby Mathewall: dtbs 53703b397a8SNishanth Menonendef 538