xref: /rk3399_ARM-atf/make_helpers/build_macros.mk (revision d986bae4e2a8bf0f4e31009d6b4a37809e9a4809)
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