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