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 70*8c7b944aSVijayenthiran Subramaniam# CREATE_SEQ is a recursive function to create sequence of numbers from 1 to 71*8c7b944aSVijayenthiran Subramaniam# $(2) and assign the sequence to $(1) 72*8c7b944aSVijayenthiran Subramaniamdefine CREATE_SEQ 73*8c7b944aSVijayenthiran Subramaniam$(if $(word $(2), $($(1))),\ 74*8c7b944aSVijayenthiran Subramaniam $(eval $(1) += $(words $($(1))))\ 75*8c7b944aSVijayenthiran Subramaniam $(eval $(1) := $(filter-out 0,$($(1)))),\ 76*8c7b944aSVijayenthiran Subramaniam $(eval $(1) += $(words $($(1))))\ 77*8c7b944aSVijayenthiran Subramaniam $(call CREATE_SEQ,$(1),$(2))\ 78*8c7b944aSVijayenthiran Subramaniam) 79*8c7b944aSVijayenthiran Subramaniamendef 80*8c7b944aSVijayenthiran Subramaniam 8173c99d4eSJuan Castillo# IMG_LINKERFILE defines the linker script corresponding to a BL stage 8273c99d4eSJuan Castillo# $(1) = BL stage (2, 30, 31, 32, 33) 8373c99d4eSJuan Castillodefine IMG_LINKERFILE 8473c99d4eSJuan Castillo ${BUILD_DIR}/bl$(1).ld 8573c99d4eSJuan Castilloendef 8673c99d4eSJuan Castillo 8773c99d4eSJuan Castillo# IMG_MAPFILE defines the output file describing the memory map corresponding 8873c99d4eSJuan Castillo# to a BL stage 8973c99d4eSJuan Castillo# $(1) = BL stage (2, 30, 31, 32, 33) 9073c99d4eSJuan Castillodefine IMG_MAPFILE 9173c99d4eSJuan Castillo ${BUILD_DIR}/bl$(1).map 9273c99d4eSJuan Castilloendef 9373c99d4eSJuan Castillo 9473c99d4eSJuan Castillo# IMG_ELF defines the elf file corresponding to a BL stage 9573c99d4eSJuan Castillo# $(1) = BL stage (2, 30, 31, 32, 33) 9673c99d4eSJuan Castillodefine IMG_ELF 9773c99d4eSJuan Castillo ${BUILD_DIR}/bl$(1).elf 9873c99d4eSJuan Castilloendef 9973c99d4eSJuan Castillo 10073c99d4eSJuan Castillo# IMG_DUMP defines the symbols dump file corresponding to a BL stage 10173c99d4eSJuan Castillo# $(1) = BL stage (2, 30, 31, 32, 33) 10273c99d4eSJuan Castillodefine IMG_DUMP 10373c99d4eSJuan Castillo ${BUILD_DIR}/bl$(1).dump 10473c99d4eSJuan Castilloendef 10573c99d4eSJuan Castillo 10673c99d4eSJuan Castillo# IMG_BIN defines the default image file corresponding to a BL stage 10773c99d4eSJuan Castillo# $(1) = BL stage (2, 30, 31, 32, 33) 10873c99d4eSJuan Castillodefine IMG_BIN 10973c99d4eSJuan Castillo ${BUILD_PLAT}/bl$(1).bin 11073c99d4eSJuan Castilloendef 11173c99d4eSJuan Castillo 11210cea934SMasahiro Yamada# TOOL_ADD_PAYLOAD appends the command line arguments required by fiptool to 11310cea934SMasahiro Yamada# package a new payload and/or by cert_create to generate certificate. 11410cea934SMasahiro Yamada# Optionally, it adds the dependency on this payload 11573c99d4eSJuan Castillo# $(1) = payload filename (i.e. bl31.bin) 1161e0c0784SMasahiro Yamada# $(2) = command line option for the specified payload (i.e. --soc-fw) 11736af3455SMasahiro Yamada# $(3) = tool target dependency (optional) (ex. build/fvp/release/bl31.bin) 1181dc0714fSMasahiro Yamada# $(4) = FIP prefix (optional) (if FWU_, target is fwu_fip instead of fip) 11910cea934SMasahiro Yamadadefine TOOL_ADD_PAYLOAD 120945b316fSMasahiro Yamada $(4)FIP_ARGS += $(2) $(1) 121945b316fSMasahiro Yamada $(if $(3),$(4)FIP_DEPS += $(3)) 122f30ee0b9SMasahiro Yamada $(4)CRT_ARGS += $(2) $(1) 123f30ee0b9SMasahiro Yamada $(if $(3),$(4)CRT_DEPS += $(3)) 12473c99d4eSJuan Castilloendef 12573c99d4eSJuan Castillo 1262da522bbSMasahiro Yamada# TOOL_ADD_IMG_PAYLOAD works like TOOL_ADD_PAYLOAD, but applies image filters 1272da522bbSMasahiro Yamada# before passing them to host tools if BL*_PRE_TOOL_FILTER is defined. 1282da522bbSMasahiro Yamada# $(1) = image_type (scp_bl2, bl33, etc.) 1292da522bbSMasahiro Yamada# $(2) = payload filepath (ex. build/fvp/release/bl31.bin) 1302da522bbSMasahiro Yamada# $(3) = command line option for the specified payload (ex. --soc-fw) 1312da522bbSMasahiro Yamada# $(4) = tool target dependency (optional) (ex. build/fvp/release/bl31.bin) 1322da522bbSMasahiro Yamada# $(5) = FIP prefix (optional) (if FWU_, target is fwu_fip instead of fip) 1332da522bbSMasahiro Yamada 1342da522bbSMasahiro Yamadadefine TOOL_ADD_IMG_PAYLOAD 1352da522bbSMasahiro Yamada 1362da522bbSMasahiro Yamada$(eval PRE_TOOL_FILTER := $($(call uppercase,$(1))_PRE_TOOL_FILTER)) 1372da522bbSMasahiro Yamada 1382da522bbSMasahiro Yamadaifneq ($(PRE_TOOL_FILTER),) 1392da522bbSMasahiro Yamada 1402da522bbSMasahiro Yamada$(eval PROCESSED_PATH := $(BUILD_PLAT)/$(1).bin$($(PRE_TOOL_FILTER)_SUFFIX)) 1412da522bbSMasahiro Yamada 1422da522bbSMasahiro Yamada$(call $(PRE_TOOL_FILTER)_RULE,$(PROCESSED_PATH),$(2)) 1432da522bbSMasahiro Yamada 1442da522bbSMasahiro Yamada$(PROCESSED_PATH): $(4) 1452da522bbSMasahiro Yamada 1462da522bbSMasahiro Yamada$(call TOOL_ADD_PAYLOAD,$(PROCESSED_PATH),$(3),$(PROCESSED_PATH),$(5)) 1472da522bbSMasahiro Yamada 1482da522bbSMasahiro Yamadaelse 1492da522bbSMasahiro Yamada$(call TOOL_ADD_PAYLOAD,$(2),$(3),$(4),$(5)) 1502da522bbSMasahiro Yamadaendif 1512da522bbSMasahiro Yamadaendef 1522da522bbSMasahiro Yamada 1530191262dSYatharth Kochar# CERT_ADD_CMD_OPT adds a new command line option to the cert_create invocation 15473c99d4eSJuan Castillo# $(1) = parameter filename 15573c99d4eSJuan Castillo# $(2) = cert_create command line option for the specified parameter 15691704d9dSMasahiro Yamada# $(3) = FIP prefix (optional) (if FWU_, target is fwu_fip instead of fip) 15773c99d4eSJuan Castillodefine CERT_ADD_CMD_OPT 15891704d9dSMasahiro Yamada $(3)CRT_ARGS += $(2) $(1) 15973c99d4eSJuan Castilloendef 16073c99d4eSJuan Castillo 161c939d13aSMasahiro Yamada# TOOL_ADD_IMG allows the platform to specify an external image to be packed 162c939d13aSMasahiro Yamada# in the FIP and/or for which certificate is generated. It also adds a 163c939d13aSMasahiro Yamada# dependency on the image file, aborting the build if the file does not exist. 16433950dd8SMasahiro Yamada# $(1) = image_type (scp_bl2, bl33, etc.) 1651e0c0784SMasahiro Yamada# $(2) = command line option for fiptool (--scp-fw, --nt-fw, etc) 1661dc0714fSMasahiro Yamada# $(3) = FIP prefix (optional) (if FWU_, target is fwu_fip instead of fip) 16773c99d4eSJuan Castillo# Example: 16833950dd8SMasahiro Yamada# $(eval $(call TOOL_ADD_IMG,bl33,--nt-fw)) 169c939d13aSMasahiro Yamadadefine TOOL_ADD_IMG 17033950dd8SMasahiro Yamada # Build option to specify the image filename (SCP_BL2, BL33, etc) 17133950dd8SMasahiro Yamada # This is the uppercase form of the first parameter 17233950dd8SMasahiro Yamada $(eval _V := $(call uppercase,$(1))) 17333950dd8SMasahiro Yamada 174945b316fSMasahiro Yamada $(3)CRT_DEPS += check_$(1) 175945b316fSMasahiro Yamada $(3)FIP_DEPS += check_$(1) 1762da522bbSMasahiro Yamada $(call TOOL_ADD_IMG_PAYLOAD,$(1),$(value $(_V)),$(2),,$(3)) 1770191262dSYatharth Kochar 17887ebd20dSMasahiro Yamada.PHONY: check_$(1) 1790191262dSYatharth Kocharcheck_$(1): 18033950dd8SMasahiro Yamada $$(if $(value $(_V)),,$$(error "Platform '${PLAT}' requires $(_V). Please set $(_V) to point to the right file")) 18133950dd8SMasahiro Yamada $$(if $(wildcard $(value $(_V))),,$$(error '$(_V)=$(value $(_V))' was specified, but '$(value $(_V))' does not exist)) 1820191262dSYatharth Kocharendef 18373c99d4eSJuan Castillo 18473c99d4eSJuan Castillo################################################################################ 18514db8908SMasahiro Yamada# Generic image processing filters 18614db8908SMasahiro Yamada################################################################################ 18714db8908SMasahiro Yamada 18814db8908SMasahiro Yamada# GZIP 18914db8908SMasahiro Yamadadefine GZIP_RULE 19014db8908SMasahiro Yamada$(1): $(2) 191ee1ba6d4SAndre Przywara $(ECHO) " GZIP $$@" 19214db8908SMasahiro Yamada $(Q)gzip -n -f -9 $$< --stdout > $$@ 19314db8908SMasahiro Yamadaendef 19414db8908SMasahiro Yamada 19514db8908SMasahiro YamadaGZIP_SUFFIX := .gz 19614db8908SMasahiro Yamada 19714db8908SMasahiro Yamada################################################################################ 19873c99d4eSJuan Castillo# Auxiliary macros to build TF images from sources 19973c99d4eSJuan Castillo################################################################################ 20073c99d4eSJuan Castillo 2011d274ab0SMasahiro YamadaMAKE_DEP = -Wp,-MD,$(DEP) -MT $$@ -MP 20273c99d4eSJuan Castillo 2035fee0287SRoberto Vargas 2045fee0287SRoberto Vargas# MAKE_C_LIB builds a C source file and generates the dependency file 2055fee0287SRoberto Vargas# $(1) = output directory 2065fee0287SRoberto Vargas# $(2) = source file (%.c) 2075fee0287SRoberto Vargas# $(3) = library name 2085fee0287SRoberto Vargasdefine MAKE_C_LIB 2095fee0287SRoberto Vargas$(eval OBJ := $(1)/$(patsubst %.c,%.o,$(notdir $(2)))) 2105fee0287SRoberto Vargas$(eval DEP := $(patsubst %.o,%.d,$(OBJ))) 2115fee0287SRoberto Vargas 2125fee0287SRoberto Vargas$(OBJ): $(2) $(filter-out %.d,$(MAKEFILE_LIST)) | lib$(3)_dirs 213ee1ba6d4SAndre Przywara $$(ECHO) " CC $$<" 2145fee0287SRoberto Vargas $$(Q)$$(CC) $$(TF_CFLAGS) $$(CFLAGS) $(MAKE_DEP) -c $$< -o $$@ 2155fee0287SRoberto Vargas 2165fee0287SRoberto Vargas-include $(DEP) 2175fee0287SRoberto Vargas 2185fee0287SRoberto Vargasendef 2195fee0287SRoberto Vargas 22070b0f278SAntonio Nino Diaz# MAKE_S_LIB builds an assembly source file and generates the dependency file 22170b0f278SAntonio Nino Diaz# $(1) = output directory 22270b0f278SAntonio Nino Diaz# $(2) = source file (%.S) 22370b0f278SAntonio Nino Diaz# $(3) = library name 22470b0f278SAntonio Nino Diazdefine MAKE_S_LIB 22570b0f278SAntonio Nino Diaz$(eval OBJ := $(1)/$(patsubst %.S,%.o,$(notdir $(2)))) 22670b0f278SAntonio Nino Diaz$(eval DEP := $(patsubst %.o,%.d,$(OBJ))) 22770b0f278SAntonio Nino Diaz 22870b0f278SAntonio Nino Diaz$(OBJ): $(2) $(filter-out %.d,$(MAKEFILE_LIST)) | lib$(3)_dirs 22970b0f278SAntonio Nino Diaz $$(ECHO) " AS $$<" 23070b0f278SAntonio Nino Diaz $$(Q)$$(AS) $$(ASFLAGS) $(MAKE_DEP) -c $$< -o $$@ 23170b0f278SAntonio Nino Diaz 23270b0f278SAntonio Nino Diaz-include $(DEP) 23370b0f278SAntonio Nino Diaz 23470b0f278SAntonio Nino Diazendef 23570b0f278SAntonio Nino Diaz 2365fee0287SRoberto Vargas 23773c99d4eSJuan Castillo# MAKE_C builds a C source file and generates the dependency file 23873c99d4eSJuan Castillo# $(1) = output directory 23973c99d4eSJuan Castillo# $(2) = source file (%.c) 2405ba8f669SYatharth Kochar# $(3) = BL stage (2, 2u, 30, 31, 32, 33) 24173c99d4eSJuan Castillodefine MAKE_C 24273c99d4eSJuan Castillo 24373c99d4eSJuan Castillo$(eval OBJ := $(1)/$(patsubst %.c,%.o,$(notdir $(2)))) 244710ea1d0SMasahiro Yamada$(eval DEP := $(patsubst %.o,%.d,$(OBJ))) 2455ba8f669SYatharth Kochar$(eval IMAGE := IMAGE_BL$(call uppercase,$(3))) 2463661f16cSJeenu Viswambharan$(eval BL_CFLAGS := $(BL$(call uppercase,$(3))_CFLAGS)) 24773c99d4eSJuan Castillo 2486bc1a30cSStephen Warren$(OBJ): $(2) $(filter-out %.d,$(MAKEFILE_LIST)) | bl$(3)_dirs 249ee1ba6d4SAndre Przywara $$(ECHO) " CC $$<" 250edbce9aaSzelalem-aweke $$(Q)$$(CC) $$(LTO_CFLAGS) $$(TF_CFLAGS) $$(CFLAGS) $(BL_CFLAGS) -D$(IMAGE) $(MAKE_DEP) -c $$< -o $$@ 25173c99d4eSJuan Castillo 252710ea1d0SMasahiro Yamada-include $(DEP) 25373c99d4eSJuan Castillo 25473c99d4eSJuan Castilloendef 25573c99d4eSJuan Castillo 25673c99d4eSJuan Castillo 25773c99d4eSJuan Castillo# MAKE_S builds an assembly source file and generates the dependency file 25873c99d4eSJuan Castillo# $(1) = output directory 25973c99d4eSJuan Castillo# $(2) = assembly file (%.S) 2605ba8f669SYatharth Kochar# $(3) = BL stage (2, 2u, 30, 31, 32, 33) 26173c99d4eSJuan Castillodefine MAKE_S 26273c99d4eSJuan Castillo 26373c99d4eSJuan Castillo$(eval OBJ := $(1)/$(patsubst %.S,%.o,$(notdir $(2)))) 264710ea1d0SMasahiro Yamada$(eval DEP := $(patsubst %.o,%.d,$(OBJ))) 2655ba8f669SYatharth Kochar$(eval IMAGE := IMAGE_BL$(call uppercase,$(3))) 26673c99d4eSJuan Castillo 2676bc1a30cSStephen Warren$(OBJ): $(2) $(filter-out %.d,$(MAKEFILE_LIST)) | bl$(3)_dirs 268ee1ba6d4SAndre Przywara $$(ECHO) " AS $$<" 269710ea1d0SMasahiro Yamada $$(Q)$$(AS) $$(ASFLAGS) -D$(IMAGE) $(MAKE_DEP) -c $$< -o $$@ 27073c99d4eSJuan Castillo 271710ea1d0SMasahiro Yamada-include $(DEP) 27273c99d4eSJuan Castillo 27373c99d4eSJuan Castilloendef 27473c99d4eSJuan Castillo 27573c99d4eSJuan Castillo 27673c99d4eSJuan Castillo# MAKE_LD generate the linker script using the C preprocessor 27773c99d4eSJuan Castillo# $(1) = output linker script 27873c99d4eSJuan Castillo# $(2) = input template 279a6ca7888SMasahiro Yamada# $(3) = BL stage (2, 2u, 30, 31, 32, 33) 28073c99d4eSJuan Castillodefine MAKE_LD 28173c99d4eSJuan Castillo 282710ea1d0SMasahiro Yamada$(eval DEP := $(1).d) 2831a4b46d5SDaniel Boulby$(eval IMAGE := IMAGE_BL$(call uppercase,$(3))) 28473c99d4eSJuan Castillo 2856bc1a30cSStephen Warren$(1): $(2) $(filter-out %.d,$(MAKEFILE_LIST)) | bl$(3)_dirs 286ee1ba6d4SAndre Przywara $$(ECHO) " PP $$<" 287402b3cf8SJulius Werner $$(Q)$$(CPP) $$(CPPFLAGS) $(TF_CFLAGS_$(ARCH)) -P -x assembler-with-cpp -D__LINKER__ $(MAKE_DEP) -D$(IMAGE) -o $$@ $$< 28873c99d4eSJuan Castillo 289710ea1d0SMasahiro Yamada-include $(DEP) 29073c99d4eSJuan Castillo 29173c99d4eSJuan Castilloendef 29273c99d4eSJuan Castillo 29370b0f278SAntonio Nino Diaz# MAKE_LIB_OBJS builds both C and assembly source files 2945fee0287SRoberto Vargas# $(1) = output directory 2955fee0287SRoberto Vargas# $(2) = list of source files 2965fee0287SRoberto Vargas# $(3) = name of the library 2975fee0287SRoberto Vargasdefine MAKE_LIB_OBJS 2985fee0287SRoberto Vargas $(eval C_OBJS := $(filter %.c,$(2))) 2995fee0287SRoberto Vargas $(eval REMAIN := $(filter-out %.c,$(2))) 3005fee0287SRoberto Vargas $(eval $(foreach obj,$(C_OBJS),$(call MAKE_C_LIB,$(1),$(obj),$(3)))) 3015fee0287SRoberto Vargas 30270b0f278SAntonio Nino Diaz $(eval S_OBJS := $(filter %.S,$(REMAIN))) 30370b0f278SAntonio Nino Diaz $(eval REMAIN := $(filter-out %.S,$(REMAIN))) 30470b0f278SAntonio Nino Diaz $(eval $(foreach obj,$(S_OBJS),$(call MAKE_S_LIB,$(1),$(obj),$(3)))) 30570b0f278SAntonio Nino Diaz 3065fee0287SRoberto Vargas $(and $(REMAIN),$(error Unexpected source files present: $(REMAIN))) 3075fee0287SRoberto Vargasendef 3085fee0287SRoberto Vargas 30973c99d4eSJuan Castillo 31073c99d4eSJuan Castillo# MAKE_OBJS builds both C and assembly source files 31173c99d4eSJuan Castillo# $(1) = output directory 31273c99d4eSJuan Castillo# $(2) = list of source files (both C and assembly) 31373c99d4eSJuan Castillo# $(3) = BL stage (2, 30, 31, 32, 33) 31473c99d4eSJuan Castillodefine MAKE_OBJS 31573c99d4eSJuan Castillo $(eval C_OBJS := $(filter %.c,$(2))) 31673c99d4eSJuan Castillo $(eval REMAIN := $(filter-out %.c,$(2))) 31773c99d4eSJuan Castillo $(eval $(foreach obj,$(C_OBJS),$(call MAKE_C,$(1),$(obj),$(3)))) 31873c99d4eSJuan Castillo 31973c99d4eSJuan Castillo $(eval S_OBJS := $(filter %.S,$(REMAIN))) 32073c99d4eSJuan Castillo $(eval REMAIN := $(filter-out %.S,$(REMAIN))) 32173c99d4eSJuan Castillo $(eval $(foreach obj,$(S_OBJS),$(call MAKE_S,$(1),$(obj),$(3)))) 32273c99d4eSJuan Castillo 32373c99d4eSJuan Castillo $(and $(REMAIN),$(error Unexpected source files present: $(REMAIN))) 32473c99d4eSJuan Castilloendef 32573c99d4eSJuan Castillo 32673c99d4eSJuan Castillo 32773c99d4eSJuan Castillo# NOTE: The line continuation '\' is required in the next define otherwise we 32873c99d4eSJuan Castillo# end up with a line-feed characer at the end of the last c filename. 329e7f54dbdSEvan Lloyd# Also bear this issue in mind if extending the list of supported filetypes. 33073c99d4eSJuan Castillodefine SOURCES_TO_OBJS 33173c99d4eSJuan Castillo $(notdir $(patsubst %.c,%.o,$(filter %.c,$(1)))) \ 33273c99d4eSJuan Castillo $(notdir $(patsubst %.S,%.o,$(filter %.S,$(1)))) 33373c99d4eSJuan Castilloendef 33473c99d4eSJuan Castillo 3352f5d4a48SPatrick Georgi# Allow overriding the timestamp, for example for reproducible builds, or to 3362f5d4a48SPatrick Georgi# synchronize timestamps across multiple projects. 3372f5d4a48SPatrick Georgi# This must be set to a C string (including quotes where applicable). 3382f5d4a48SPatrick GeorgiBUILD_MESSAGE_TIMESTAMP ?= __TIME__", "__DATE__ 33973c99d4eSJuan Castillo 3405fee0287SRoberto Vargas.PHONY: libraries 3415fee0287SRoberto Vargas 3425accce5bSRoberto Vargas# MAKE_LIB_DIRS macro defines the target for the directory where 3435fee0287SRoberto Vargas# libraries are created 3445accce5bSRoberto Vargasdefine MAKE_LIB_DIRS 3455fee0287SRoberto Vargas $(eval LIB_DIR := ${BUILD_PLAT}/lib) 3465accce5bSRoberto Vargas $(eval ROMLIB_DIR := ${BUILD_PLAT}/romlib) 3475accce5bSRoberto Vargas $(eval LIBWRAPPER_DIR := ${BUILD_PLAT}/libwrapper) 3485fee0287SRoberto Vargas $(eval $(call MAKE_PREREQ_DIR,${LIB_DIR},${BUILD_PLAT})) 3495accce5bSRoberto Vargas $(eval $(call MAKE_PREREQ_DIR,${ROMLIB_DIR},${BUILD_PLAT})) 3505accce5bSRoberto Vargas $(eval $(call MAKE_PREREQ_DIR,${LIBWRAPPER_DIR},${BUILD_PLAT})) 3515fee0287SRoberto Vargasendef 3525fee0287SRoberto Vargas 3535fee0287SRoberto Vargas# MAKE_LIB macro defines the targets and options to build each BL image. 3545fee0287SRoberto Vargas# Arguments: 3555fee0287SRoberto Vargas# $(1) = Library name 3565fee0287SRoberto Vargasdefine MAKE_LIB 3575fee0287SRoberto Vargas $(eval BUILD_DIR := ${BUILD_PLAT}/lib$(1)) 3585fee0287SRoberto Vargas $(eval LIB_DIR := ${BUILD_PLAT}/lib) 3595accce5bSRoberto Vargas $(eval ROMLIB_DIR := ${BUILD_PLAT}/romlib) 3605fee0287SRoberto Vargas $(eval SOURCES := $(LIB$(call uppercase,$(1))_SRCS)) 3615fee0287SRoberto Vargas $(eval OBJS := $(addprefix $(BUILD_DIR)/,$(call SOURCES_TO_OBJS,$(SOURCES)))) 3625fee0287SRoberto Vargas 3635fee0287SRoberto Vargas$(eval $(call MAKE_PREREQ_DIR,${BUILD_DIR},${BUILD_PLAT})) 3645fee0287SRoberto Vargas$(eval $(call MAKE_LIB_OBJS,$(BUILD_DIR),$(SOURCES),$(1))) 3655fee0287SRoberto Vargas 3665fee0287SRoberto Vargas.PHONY : lib${1}_dirs 3675accce5bSRoberto Vargaslib${1}_dirs: | ${BUILD_DIR} ${LIB_DIR} ${ROMLIB_DIR} ${LIBWRAPPER_DIR} 3685fee0287SRoberto Vargaslibraries: ${LIB_DIR}/lib$(1).a 369c2ad38ceSVarun Wadekarifneq ($(findstring armlink,$(notdir $(LD))),) 370c2ad38ceSVarun WadekarLDPATHS = --userlibpath=${LIB_DIR} 371c2ad38ceSVarun WadekarLDLIBS += --library=$(1) 372c2ad38ceSVarun Wadekarelse 3735fee0287SRoberto VargasLDPATHS = -L${LIB_DIR} 3745fee0287SRoberto VargasLDLIBS += -l$(1) 375c2ad38ceSVarun Wadekarendif 3765fee0287SRoberto Vargas 3775accce5bSRoberto Vargasifeq ($(USE_ROMLIB),1) 3786baf85b3SSathees BalyaLIBWRAPPER = -lwrappers 3795accce5bSRoberto Vargasendif 3805accce5bSRoberto Vargas 3815fee0287SRoberto Vargasall: ${LIB_DIR}/lib$(1).a 3825fee0287SRoberto Vargas 3835fee0287SRoberto Vargas${LIB_DIR}/lib$(1).a: $(OBJS) 384ee1ba6d4SAndre Przywara $$(ECHO) " AR $$@" 3855fee0287SRoberto Vargas $$(Q)$$(AR) cr $$@ $$? 3865fee0287SRoberto Vargasendef 3875fee0287SRoberto Vargas 38873c99d4eSJuan Castillo# MAKE_BL macro defines the targets and options to build each BL image. 38973c99d4eSJuan Castillo# Arguments: 3905ba8f669SYatharth Kochar# $(1) = BL stage (2, 2u, 30, 31, 32, 33) 3918f0617efSJuan Castillo# $(2) = FIP command line option (if empty, image will not be included in the FIP) 3921dc0714fSMasahiro Yamada# $(3) = FIP prefix (optional) (if FWU_, target is fwu_fip instead of fip) 39373c99d4eSJuan Castillodefine MAKE_BL 39473c99d4eSJuan Castillo $(eval BUILD_DIR := ${BUILD_PLAT}/bl$(1)) 3955ba8f669SYatharth Kochar $(eval BL_SOURCES := $(BL$(call uppercase,$(1))_SOURCES)) 3965ba8f669SYatharth Kochar $(eval SOURCES := $(BL_SOURCES) $(BL_COMMON_SOURCES) $(PLAT_BL_COMMON_SOURCES)) 39773c99d4eSJuan Castillo $(eval OBJS := $(addprefix $(BUILD_DIR)/,$(call SOURCES_TO_OBJS,$(SOURCES)))) 39873c99d4eSJuan Castillo $(eval LINKERFILE := $(call IMG_LINKERFILE,$(1))) 39973c99d4eSJuan Castillo $(eval MAPFILE := $(call IMG_MAPFILE,$(1))) 40073c99d4eSJuan Castillo $(eval ELF := $(call IMG_ELF,$(1))) 40173c99d4eSJuan Castillo $(eval DUMP := $(call IMG_DUMP,$(1))) 40273c99d4eSJuan Castillo $(eval BIN := $(call IMG_BIN,$(1))) 4035ba8f669SYatharth Kochar $(eval BL_LINKERFILE := $(BL$(call uppercase,$(1))_LINKERFILE)) 40423e0fe52SKonstantin Porotchkin $(eval BL_LIBS := $(BL$(call uppercase,$(1))_LIBS)) 40551b27702SEvan Lloyd # We use sort only to get a list of unique object directory names. 40651b27702SEvan Lloyd # ordering is not relevant but sort removes duplicates. 4076ba7d274SEvan Lloyd $(eval TEMP_OBJ_DIRS := $(sort $(dir ${OBJS} ${LINKERFILE}))) 40851b27702SEvan Lloyd # The $(dir ) function leaves a trailing / on the directory names 409d014ea6cSMasahiro Yamada # Rip off the / to match directory names with make rule targets. 410d014ea6cSMasahiro Yamada $(eval OBJ_DIRS := $(patsubst %/,%,$(TEMP_OBJ_DIRS))) 41151b27702SEvan Lloyd 41251b27702SEvan Lloyd# Create generators for object directory structure 41351b27702SEvan Lloyd 4148012cc5cSMasahiro Yamada$(eval $(call MAKE_PREREQ_DIR,${BUILD_DIR},${BUILD_PLAT})) 4156ba7d274SEvan Lloyd 4166ba7d274SEvan Lloyd$(eval $(foreach objd,${OBJ_DIRS},$(call MAKE_PREREQ_DIR,${objd},${BUILD_DIR}))) 41751b27702SEvan Lloyd 41851b27702SEvan Lloyd.PHONY : bl${1}_dirs 41951b27702SEvan Lloyd 42051b27702SEvan Lloyd# We use order-only prerequisites to ensure that directories are created, 42151b27702SEvan Lloyd# but do not cause re-builds every time a file is written. 42251b27702SEvan Lloydbl${1}_dirs: | ${OBJ_DIRS} 42373c99d4eSJuan Castillo 42473c99d4eSJuan Castillo$(eval $(call MAKE_OBJS,$(BUILD_DIR),$(SOURCES),$(1))) 425a6ca7888SMasahiro Yamada$(eval $(call MAKE_LD,$(LINKERFILE),$(BL_LINKERFILE),$(1))) 426d986bae4SMasahiro Yamada$(eval BL_LDFLAGS := $(BL$(call uppercase,$(1))_LDFLAGS)) 42773c99d4eSJuan Castillo 4285accce5bSRoberto Vargasifeq ($(USE_ROMLIB),1) 4295accce5bSRoberto Vargas$(ELF): romlib.bin 4305accce5bSRoberto Vargasendif 4315accce5bSRoberto Vargas 4325fee0287SRoberto Vargas$(ELF): $(OBJS) $(LINKERFILE) | bl$(1)_dirs libraries $(BL_LIBS) 433ee1ba6d4SAndre Przywara $$(ECHO) " LD $$@" 434414ab853SEvan Lloydifdef MAKE_BUILD_STRINGS 435414ab853SEvan Lloyd $(call MAKE_BUILD_STRINGS, $(BUILD_DIR)/build_message.o) 436414ab853SEvan Lloydelse 4372f5d4a48SPatrick Georgi @echo 'const char build_message[] = "Built : "$(BUILD_MESSAGE_TIMESTAMP); \ 43873c99d4eSJuan Castillo const char version_string[] = "${VERSION_STRING}";' | \ 439f2e1d57eSMasahiro Yamada $$(CC) $$(TF_CFLAGS) $$(CFLAGS) -xc -c - -o $(BUILD_DIR)/build_message.o 440414ab853SEvan Lloydendif 441c2ad38ceSVarun Wadekarifneq ($(findstring armlink,$(notdir $(LD))),) 442d986bae4SMasahiro Yamada $$(Q)$$(LD) -o $$@ $$(TF_LDFLAGS) $$(LDFLAGS) $(BL_LDFLAGS) --entry=bl${1}_entrypoint \ 443c2ad38ceSVarun Wadekar --predefine="-D__LINKER__=$(__LINKER__)" \ 444c2ad38ceSVarun Wadekar --predefine="-DTF_CFLAGS=$(TF_CFLAGS)" \ 445c2ad38ceSVarun Wadekar --map --list="$(MAPFILE)" --scatter=${PLAT_DIR}/scat/bl${1}.scat \ 446c2ad38ceSVarun Wadekar $(LDPATHS) $(LIBWRAPPER) $(LDLIBS) $(BL_LIBS) \ 447c2ad38ceSVarun Wadekar $(BUILD_DIR)/build_message.o $(OBJS) 448edbce9aaSzelalem-awekeelse ifneq ($(findstring gcc,$(notdir $(LD))),) 449edbce9aaSzelalem-aweke $$(Q)$$(LD) -o $$@ $$(TF_LDFLAGS) $$(LDFLAGS) -Wl,-Map=$(MAPFILE) \ 450edbce9aaSzelalem-aweke -Wl,-T$(LINKERFILE) $(BUILD_DIR)/build_message.o \ 451edbce9aaSzelalem-aweke $(OBJS) $(LDPATHS) $(LIBWRAPPER) $(LDLIBS) $(BL_LIBS) 452c2ad38ceSVarun Wadekarelse 453d986bae4SMasahiro Yamada $$(Q)$$(LD) -o $$@ $$(TF_LDFLAGS) $$(LDFLAGS) $(BL_LDFLAGS) -Map=$(MAPFILE) \ 4545fee0287SRoberto Vargas --script $(LINKERFILE) $(BUILD_DIR)/build_message.o \ 4556baf85b3SSathees Balya $(OBJS) $(LDPATHS) $(LIBWRAPPER) $(LDLIBS) $(BL_LIBS) 456c2ad38ceSVarun Wadekarendif 4579e4609f1SChristoph Müllnerifeq ($(DISABLE_BIN_GENERATION),1) 4589e4609f1SChristoph Müllner @${ECHO_BLANK_LINE} 4599e4609f1SChristoph Müllner @echo "Built $$@ successfully" 4609e4609f1SChristoph Müllner @${ECHO_BLANK_LINE} 4619e4609f1SChristoph Müllnerendif 46273c99d4eSJuan Castillo 46373c99d4eSJuan Castillo$(DUMP): $(ELF) 464ee1ba6d4SAndre Przywara $${ECHO} " OD $$@" 46573c99d4eSJuan Castillo $${Q}$${OD} -dx $$< > $$@ 46673c99d4eSJuan Castillo 46773c99d4eSJuan Castillo$(BIN): $(ELF) 468ee1ba6d4SAndre Przywara $${ECHO} " BIN $$@" 46973c99d4eSJuan Castillo $$(Q)$$(OC) -O binary $$< $$@ 470052ab529SEvan Lloyd @${ECHO_BLANK_LINE} 47173c99d4eSJuan Castillo @echo "Built $$@ successfully" 472052ab529SEvan Lloyd @${ECHO_BLANK_LINE} 47373c99d4eSJuan Castillo 47473c99d4eSJuan Castillo.PHONY: bl$(1) 4759e4609f1SChristoph Müllnerifeq ($(DISABLE_BIN_GENERATION),1) 4769e4609f1SChristoph Müllnerbl$(1): $(ELF) $(DUMP) 4779e4609f1SChristoph Müllnerelse 47851b27702SEvan Lloydbl$(1): $(BIN) $(DUMP) 4799e4609f1SChristoph Müllnerendif 48073c99d4eSJuan Castillo 48173c99d4eSJuan Castilloall: bl$(1) 48273c99d4eSJuan Castillo 4832da522bbSMasahiro Yamada$(if $(2),$(call TOOL_ADD_IMG_PAYLOAD,bl$(1),$(BIN),--$(2),$(BIN),$(3))) 48473c99d4eSJuan Castillo 48573c99d4eSJuan Castilloendef 48673c99d4eSJuan Castillo 48738c14d88SSoby Mathew# Convert device tree source file names to matching blobs 48838c14d88SSoby Mathew# $(1) = input dts 48903b397a8SNishanth Menondefine SOURCES_TO_DTBS 49003b397a8SNishanth Menon $(notdir $(patsubst %.dts,%.dtb,$(filter %.dts,$(1)))) 49103b397a8SNishanth Menonendef 49203b397a8SNishanth Menon 49338c14d88SSoby Mathew# MAKE_FDT_DIRS macro creates the prerequisite directories that host the 49438c14d88SSoby Mathew# FDT binaries 49538c14d88SSoby Mathew# $(1) = output directory 49638c14d88SSoby Mathew# $(2) = input dts 49738c14d88SSoby Mathewdefine MAKE_FDT_DIRS 49838c14d88SSoby Mathew $(eval DTBS := $(addprefix $(1)/,$(call SOURCES_TO_DTBS,$(2)))) 49903b397a8SNishanth Menon $(eval TEMP_DTB_DIRS := $(sort $(dir ${DTBS}))) 50003b397a8SNishanth Menon # The $(dir ) function leaves a trailing / on the directory names 50103b397a8SNishanth Menon # Rip off the / to match directory names with make rule targets. 50203b397a8SNishanth Menon $(eval DTB_DIRS := $(patsubst %/,%,$(TEMP_DTB_DIRS))) 50303b397a8SNishanth Menon 50403b397a8SNishanth Menon$(eval $(foreach objd,${DTB_DIRS},$(call MAKE_PREREQ_DIR,${objd},${BUILD_DIR}))) 50503b397a8SNishanth Menon 50603b397a8SNishanth Menonfdt_dirs: ${DTB_DIRS} 50703b397a8SNishanth Menonendef 50803b397a8SNishanth Menon 50938c14d88SSoby Mathew# MAKE_DTB generate the Flattened device tree binary 51003b397a8SNishanth Menon# $(1) = output directory 51103b397a8SNishanth Menon# $(2) = input dts 51203b397a8SNishanth Menondefine MAKE_DTB 51303b397a8SNishanth Menon 514077b3e9aSYann Gautier# List of DTB file(s) to generate, based on DTS file basename list 51538c14d88SSoby Mathew$(eval DOBJ := $(addprefix $(1)/,$(call SOURCES_TO_DTBS,$(2)))) 516077b3e9aSYann Gautier# List of the pre-compiled DTS file(s) 51701d237cbSYann Gautier$(eval DPRE := $(addprefix $(1)/,$(patsubst %.dts,%.pre.dts,$(notdir $(2))))) 518077b3e9aSYann Gautier# Dependencies of the pre-compiled DTS file(s) on its source and included files 519077b3e9aSYann Gautier$(eval DTSDEP := $(patsubst %.dtb,%.o.d,$(DOBJ))) 520077b3e9aSYann Gautier# Dependencies of the DT compilation on its pre-compiled DTS 521077b3e9aSYann Gautier$(eval DTBDEP := $(patsubst %.dtb,%.d,$(DOBJ))) 52203b397a8SNishanth Menon 5236bc1a30cSStephen Warren$(DOBJ): $(2) $(filter-out %.d,$(MAKEFILE_LIST)) | fdt_dirs 524ee1ba6d4SAndre Przywara $${ECHO} " CPP $$<" 525077b3e9aSYann Gautier $(eval DTBS := $(addprefix $(1)/,$(call SOURCES_TO_DTBS,$(2)))) 5267e94a699SManish Pandey $$(Q)$$(PP) $$(DTC_CPPFLAGS) -MT $(DTBS) -MMD -MF $(DTSDEP) -o $(DPRE) $$< 527ee1ba6d4SAndre Przywara $${ECHO} " DTC $$<" 5282d51b55eSBalint Dobszay $$(Q)$$(DTC) $$(DTC_FLAGS) -d $(DTBDEP) -o $$@ $(DPRE) 52903b397a8SNishanth Menon 530077b3e9aSYann Gautier-include $(DTBDEP) 531077b3e9aSYann Gautier-include $(DTSDEP) 53203b397a8SNishanth Menon 53303b397a8SNishanth Menonendef 53403b397a8SNishanth Menon 53503b397a8SNishanth Menon# MAKE_DTBS builds flattened device tree sources 53603b397a8SNishanth Menon# $(1) = output directory 53703b397a8SNishanth Menon# $(2) = list of flattened device tree source files 53803b397a8SNishanth Menondefine MAKE_DTBS 53903b397a8SNishanth Menon $(eval DOBJS := $(filter %.dts,$(2))) 54003b397a8SNishanth Menon $(eval REMAIN := $(filter-out %.dts,$(2))) 54138c14d88SSoby Mathew $(and $(REMAIN),$(error FDT_SOURCES contain non-DTS files: $(REMAIN))) 54203b397a8SNishanth Menon $(eval $(foreach obj,$(DOBJS),$(call MAKE_DTB,$(1),$(obj)))) 54303b397a8SNishanth Menon 54438c14d88SSoby Mathew $(eval $(call MAKE_FDT_DIRS,$(1),$(2))) 54538c14d88SSoby Mathew 54638c14d88SSoby Mathewdtbs: $(DTBS) 54738c14d88SSoby Mathewall: dtbs 54803b397a8SNishanth Menonendef 549