2015-08-18 13:23:04 +00:00
|
|
|
#
|
2019-02-08 13:20:37 +00:00
|
|
|
# Copyright (c) 2015-2019, ARM Limited and Contributors. All rights reserved.
|
2015-08-18 13:23:04 +00:00
|
|
|
#
|
2017-05-03 08:38:09 +00:00
|
|
|
# SPDX-License-Identifier: BSD-3-Clause
|
2015-08-18 13:23:04 +00:00
|
|
|
#
|
|
|
|
|
2015-12-02 18:41:22 +00:00
|
|
|
# Report an error if the eval make function is not available.
|
|
|
|
$(eval eval_available := T)
|
|
|
|
ifneq (${eval_available},T)
|
|
|
|
$(error This makefile only works with a Make program that supports $$(eval))
|
|
|
|
endif
|
|
|
|
|
2015-12-02 18:17:37 +00:00
|
|
|
# Some utility macros for manipulating awkward (whitespace) characters.
|
|
|
|
blank :=
|
|
|
|
space :=${blank} ${blank}
|
|
|
|
|
|
|
|
# A user defined function to recursively search for a filename below a directory
|
|
|
|
# $1 is the directory root of the recursive search (blank for current directory).
|
|
|
|
# $2 is the file name to search for.
|
|
|
|
define rwildcard
|
|
|
|
$(strip $(foreach d,$(wildcard ${1}*),$(call rwildcard,${d}/,${2}) $(filter $(subst *,%,%${2}),${d})))
|
|
|
|
endef
|
|
|
|
|
2015-10-02 12:58:52 +00:00
|
|
|
# This table is used in converting lower case to upper case.
|
|
|
|
uppercase_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
|
|
|
|
|
|
|
|
# Internal macro used for converting lower case to upper case.
|
|
|
|
# $(1) = upper case table
|
|
|
|
# $(2) = String to convert
|
|
|
|
define uppercase_internal
|
|
|
|
$(if $(1),$$(subst $(firstword $(1)),$(call uppercase_internal,$(wordlist 2,$(words $(1)),$(1)),$(2))),$(2))
|
|
|
|
endef
|
|
|
|
|
|
|
|
# A macro for converting a string to upper case
|
|
|
|
# $(1) = String to convert
|
|
|
|
define uppercase
|
|
|
|
$(eval uppercase_result:=$(call uppercase_internal,$(uppercase_table),$(1)))$(uppercase_result)
|
|
|
|
endef
|
|
|
|
|
2015-08-18 13:23:04 +00:00
|
|
|
# Convenience function for adding build definitions
|
|
|
|
# $(eval $(call add_define,FOO)) will have:
|
|
|
|
# -DFOO if $(FOO) is empty; -DFOO=$(FOO) otherwise
|
|
|
|
define add_define
|
|
|
|
DEFINES += -D$(1)$(if $(value $(1)),=$(value $(1)),)
|
|
|
|
endef
|
|
|
|
|
2016-06-09 20:36:27 +00:00
|
|
|
# Convenience function for adding build definitions
|
|
|
|
# $(eval $(call add_define_val,FOO,BAR)) will have:
|
|
|
|
# -DFOO=BAR
|
|
|
|
define add_define_val
|
|
|
|
DEFINES += -D$(1)=$(2)
|
|
|
|
endef
|
|
|
|
|
2015-08-18 13:23:04 +00:00
|
|
|
# Convenience function for verifying option has a boolean value
|
|
|
|
# $(eval $(call assert_boolean,FOO)) will assert FOO is 0 or 1
|
|
|
|
define assert_boolean
|
2017-05-23 14:45:01 +00:00
|
|
|
$(if $(filter-out 0 1,$($1)),$(error $1 must be boolean))
|
2015-08-18 13:23:04 +00:00
|
|
|
endef
|
|
|
|
|
2017-01-16 16:52:35 +00:00
|
|
|
0-9 := 0 1 2 3 4 5 6 7 8 9
|
|
|
|
|
|
|
|
# Function to verify that a given option $(1) contains a numeric value
|
|
|
|
define assert_numeric
|
|
|
|
$(if $($(1)),,$(error $(1) must not be empty))
|
|
|
|
$(eval __numeric := $($(1)))
|
|
|
|
$(foreach d,$(0-9),$(eval __numeric := $(subst $(d),,$(__numeric))))
|
|
|
|
$(if $(__numeric),$(error $(1) must be numeric))
|
|
|
|
endef
|
|
|
|
|
2015-08-18 13:23:04 +00:00
|
|
|
# IMG_LINKERFILE defines the linker script corresponding to a BL stage
|
|
|
|
# $(1) = BL stage (2, 30, 31, 32, 33)
|
|
|
|
define IMG_LINKERFILE
|
|
|
|
${BUILD_DIR}/bl$(1).ld
|
|
|
|
endef
|
|
|
|
|
|
|
|
# IMG_MAPFILE defines the output file describing the memory map corresponding
|
|
|
|
# to a BL stage
|
|
|
|
# $(1) = BL stage (2, 30, 31, 32, 33)
|
|
|
|
define IMG_MAPFILE
|
|
|
|
${BUILD_DIR}/bl$(1).map
|
|
|
|
endef
|
|
|
|
|
|
|
|
# IMG_ELF defines the elf file corresponding to a BL stage
|
|
|
|
# $(1) = BL stage (2, 30, 31, 32, 33)
|
|
|
|
define IMG_ELF
|
|
|
|
${BUILD_DIR}/bl$(1).elf
|
|
|
|
endef
|
|
|
|
|
|
|
|
# IMG_DUMP defines the symbols dump file corresponding to a BL stage
|
|
|
|
# $(1) = BL stage (2, 30, 31, 32, 33)
|
|
|
|
define IMG_DUMP
|
|
|
|
${BUILD_DIR}/bl$(1).dump
|
|
|
|
endef
|
|
|
|
|
|
|
|
# IMG_BIN defines the default image file corresponding to a BL stage
|
|
|
|
# $(1) = BL stage (2, 30, 31, 32, 33)
|
|
|
|
define IMG_BIN
|
|
|
|
${BUILD_PLAT}/bl$(1).bin
|
|
|
|
endef
|
|
|
|
|
2018-01-26 02:42:01 +00:00
|
|
|
# TOOL_ADD_PAYLOAD appends the command line arguments required by fiptool to
|
|
|
|
# package a new payload and/or by cert_create to generate certificate.
|
|
|
|
# Optionally, it adds the dependency on this payload
|
2015-08-18 13:23:04 +00:00
|
|
|
# $(1) = payload filename (i.e. bl31.bin)
|
2017-12-23 14:56:18 +00:00
|
|
|
# $(2) = command line option for the specified payload (i.e. --soc-fw)
|
2018-01-26 02:42:01 +00:00
|
|
|
# $(3) = tool target dependency (optional) (ex. build/fvp/release/bl31.bin)
|
2018-01-26 02:42:01 +00:00
|
|
|
# $(4) = FIP prefix (optional) (if FWU_, target is fwu_fip instead of fip)
|
2018-01-26 02:42:01 +00:00
|
|
|
define TOOL_ADD_PAYLOAD
|
2018-01-26 02:42:01 +00:00
|
|
|
$(4)FIP_ARGS += $(2) $(1)
|
|
|
|
$(if $(3),$(4)FIP_DEPS += $(3))
|
2018-01-26 02:42:01 +00:00
|
|
|
$(4)CRT_ARGS += $(2) $(1)
|
|
|
|
$(if $(3),$(4)CRT_DEPS += $(3))
|
2015-08-18 13:23:04 +00:00
|
|
|
endef
|
|
|
|
|
Build: support pre-tool image processing
There are cases where we want to process images before they are
passed to cert_create / fiptool.
My main motivation is data compression. By compressing images, we can
save data storage, and possibly speed up loading images. The image
verification will also get faster because certificates are generated
based on compressed images.
Other image transformation filters (for ex. encryption), and their
combinations would be possible. So, our build system should support
transformation filters in a generic manner.
The choice of applied filters is up to platforms (so specified in
platform.mk)
To define a new filter, <FILTER_NAME>_RULE and <FILTER_NAME>_SUFFIX
are needed.
For example, the GZIP compression filter can be implemented as follows:
------------------------>8------------------------
define GZIP_RULE
$(1): $(2)
@echo " GZIP $$@"
$(Q)gzip -n -f -9 $$< --stdout > $$@
endef
GZIP_SUFFIX := .gz
------------------------>8------------------------
The _RULE defines how to create the target $(1) from the source $(2).
The _SUFFIX defines the extension appended to the processed image path.
The suffix is not so important because the file name information is not
propagated to FIP, but adding a sensible suffix will be good to classify
the data file.
Platforms can specify which filter is applied to which BL image, like
this:
------------------------>8------------------------
BL32_PRE_TOOL_FILTER := GZIP
BL33_PRE_TOOL_FILTER := GZIP
------------------------>8------------------------
<IMAGE_NAME>_PRE_TOOL_FILTER specifies per-image filter. With this,
different images can be transformed differently. For the case above,
only BL32 and BL33 are GZIP-compressed. Nothing is done for other
images.
Signed-off-by: Masahiro Yamada <yamada.masahiro@socionext.com>
2018-02-01 07:31:09 +00:00
|
|
|
# TOOL_ADD_IMG_PAYLOAD works like TOOL_ADD_PAYLOAD, but applies image filters
|
|
|
|
# before passing them to host tools if BL*_PRE_TOOL_FILTER is defined.
|
|
|
|
# $(1) = image_type (scp_bl2, bl33, etc.)
|
|
|
|
# $(2) = payload filepath (ex. build/fvp/release/bl31.bin)
|
|
|
|
# $(3) = command line option for the specified payload (ex. --soc-fw)
|
|
|
|
# $(4) = tool target dependency (optional) (ex. build/fvp/release/bl31.bin)
|
|
|
|
# $(5) = FIP prefix (optional) (if FWU_, target is fwu_fip instead of fip)
|
|
|
|
|
|
|
|
define TOOL_ADD_IMG_PAYLOAD
|
|
|
|
|
|
|
|
$(eval PRE_TOOL_FILTER := $($(call uppercase,$(1))_PRE_TOOL_FILTER))
|
|
|
|
|
|
|
|
ifneq ($(PRE_TOOL_FILTER),)
|
|
|
|
|
|
|
|
$(eval PROCESSED_PATH := $(BUILD_PLAT)/$(1).bin$($(PRE_TOOL_FILTER)_SUFFIX))
|
|
|
|
|
|
|
|
$(call $(PRE_TOOL_FILTER)_RULE,$(PROCESSED_PATH),$(2))
|
|
|
|
|
|
|
|
$(PROCESSED_PATH): $(4)
|
|
|
|
|
|
|
|
$(call TOOL_ADD_PAYLOAD,$(PROCESSED_PATH),$(3),$(PROCESSED_PATH),$(5))
|
|
|
|
|
|
|
|
else
|
|
|
|
$(call TOOL_ADD_PAYLOAD,$(2),$(3),$(4),$(5))
|
|
|
|
endif
|
|
|
|
endef
|
|
|
|
|
2015-10-12 11:33:47 +00:00
|
|
|
# CERT_ADD_CMD_OPT adds a new command line option to the cert_create invocation
|
2015-08-18 13:23:04 +00:00
|
|
|
# $(1) = parameter filename
|
|
|
|
# $(2) = cert_create command line option for the specified parameter
|
2018-01-26 02:42:01 +00:00
|
|
|
# $(3) = FIP prefix (optional) (if FWU_, target is fwu_fip instead of fip)
|
2015-08-18 13:23:04 +00:00
|
|
|
define CERT_ADD_CMD_OPT
|
2018-01-26 02:42:01 +00:00
|
|
|
$(3)CRT_ARGS += $(2) $(1)
|
2015-08-18 13:23:04 +00:00
|
|
|
endef
|
|
|
|
|
2018-01-26 02:42:01 +00:00
|
|
|
# TOOL_ADD_IMG allows the platform to specify an external image to be packed
|
|
|
|
# in the FIP and/or for which certificate is generated. It also adds a
|
|
|
|
# dependency on the image file, aborting the build if the file does not exist.
|
2018-01-26 02:42:01 +00:00
|
|
|
# $(1) = image_type (scp_bl2, bl33, etc.)
|
2017-12-23 14:56:18 +00:00
|
|
|
# $(2) = command line option for fiptool (--scp-fw, --nt-fw, etc)
|
2018-01-26 02:42:01 +00:00
|
|
|
# $(3) = FIP prefix (optional) (if FWU_, target is fwu_fip instead of fip)
|
2015-08-18 13:23:04 +00:00
|
|
|
# Example:
|
2018-01-26 02:42:01 +00:00
|
|
|
# $(eval $(call TOOL_ADD_IMG,bl33,--nt-fw))
|
2018-01-26 02:42:01 +00:00
|
|
|
define TOOL_ADD_IMG
|
2018-01-26 02:42:01 +00:00
|
|
|
# Build option to specify the image filename (SCP_BL2, BL33, etc)
|
|
|
|
# This is the uppercase form of the first parameter
|
|
|
|
$(eval _V := $(call uppercase,$(1)))
|
|
|
|
|
2018-01-26 02:42:01 +00:00
|
|
|
$(3)CRT_DEPS += check_$(1)
|
|
|
|
$(3)FIP_DEPS += check_$(1)
|
Build: support pre-tool image processing
There are cases where we want to process images before they are
passed to cert_create / fiptool.
My main motivation is data compression. By compressing images, we can
save data storage, and possibly speed up loading images. The image
verification will also get faster because certificates are generated
based on compressed images.
Other image transformation filters (for ex. encryption), and their
combinations would be possible. So, our build system should support
transformation filters in a generic manner.
The choice of applied filters is up to platforms (so specified in
platform.mk)
To define a new filter, <FILTER_NAME>_RULE and <FILTER_NAME>_SUFFIX
are needed.
For example, the GZIP compression filter can be implemented as follows:
------------------------>8------------------------
define GZIP_RULE
$(1): $(2)
@echo " GZIP $$@"
$(Q)gzip -n -f -9 $$< --stdout > $$@
endef
GZIP_SUFFIX := .gz
------------------------>8------------------------
The _RULE defines how to create the target $(1) from the source $(2).
The _SUFFIX defines the extension appended to the processed image path.
The suffix is not so important because the file name information is not
propagated to FIP, but adding a sensible suffix will be good to classify
the data file.
Platforms can specify which filter is applied to which BL image, like
this:
------------------------>8------------------------
BL32_PRE_TOOL_FILTER := GZIP
BL33_PRE_TOOL_FILTER := GZIP
------------------------>8------------------------
<IMAGE_NAME>_PRE_TOOL_FILTER specifies per-image filter. With this,
different images can be transformed differently. For the case above,
only BL32 and BL33 are GZIP-compressed. Nothing is done for other
images.
Signed-off-by: Masahiro Yamada <yamada.masahiro@socionext.com>
2018-02-01 07:31:09 +00:00
|
|
|
$(call TOOL_ADD_IMG_PAYLOAD,$(1),$(value $(_V)),$(2),,$(3))
|
2015-10-12 11:33:47 +00:00
|
|
|
|
2017-12-24 04:08:00 +00:00
|
|
|
.PHONY: check_$(1)
|
2015-10-12 11:33:47 +00:00
|
|
|
check_$(1):
|
2018-01-26 02:42:01 +00:00
|
|
|
$$(if $(value $(_V)),,$$(error "Platform '${PLAT}' requires $(_V). Please set $(_V) to point to the right file"))
|
|
|
|
$$(if $(wildcard $(value $(_V))),,$$(error '$(_V)=$(value $(_V))' was specified, but '$(value $(_V))' does not exist))
|
2015-10-12 11:33:47 +00:00
|
|
|
endef
|
2015-08-18 13:23:04 +00:00
|
|
|
|
2018-01-26 02:42:01 +00:00
|
|
|
################################################################################
|
|
|
|
# Generic image processing filters
|
|
|
|
################################################################################
|
|
|
|
|
|
|
|
# GZIP
|
|
|
|
define GZIP_RULE
|
|
|
|
$(1): $(2)
|
Makefile: Support totally quiet output with -s
"-s" is a command line option to the make tool, to suppress normal output,
something to the effect of prepending every line with '@' in the Makefile.
However with our V={0|1} support, we now print the shortened command line
output in any case (even with V=1, in addition to the long line!).
Normally -s helps to not miss non-fatal warnings, which tend to scroll out
of the window easily.
Introduce a new Makefile variable ECHO, to control the shortened output.
We only set it in the (current default) V=0 case, and replace every
occurence of "@echo" with that variable.
When the user specifies "-s", we set ECHO to some magic string which
changes the output line into a comment, so the output is suppressed.
Beside suppressing every output for "-s", we also avoid the redundant
short output when compiling with V=1.
This changes the output to:
==========
$ make -s PLAT=.... bl31
Built build/.../release/bl31.bin
==========
$ make PLAT=.... bl31
...
CC lib/libc/strncmp.c
CC lib/libc/strnlen.c
...
==========
$ make V=1 PLAT=.... bl31
...
gcc -DDEBUG=0 .... -o build/.../release/libc/strncmp.o
gcc -DDEBUG=0 .... -o build/.../release/libc/strnlen.o
...
==========
Signed-off-by: Andre Przywara <andre.przywara@arm.com>
2018-09-27 09:56:05 +00:00
|
|
|
$(ECHO) " GZIP $$@"
|
2018-01-26 02:42:01 +00:00
|
|
|
$(Q)gzip -n -f -9 $$< --stdout > $$@
|
|
|
|
endef
|
|
|
|
|
|
|
|
GZIP_SUFFIX := .gz
|
|
|
|
|
2015-08-18 13:23:04 +00:00
|
|
|
################################################################################
|
|
|
|
# Auxiliary macros to build TF images from sources
|
|
|
|
################################################################################
|
|
|
|
|
2016-12-22 06:23:05 +00:00
|
|
|
MAKE_DEP = -Wp,-MD,$(DEP) -MT $$@ -MP
|
2015-08-18 13:23:04 +00:00
|
|
|
|
2018-05-08 09:27:10 +00:00
|
|
|
|
|
|
|
# MAKE_C_LIB builds a C source file and generates the dependency file
|
|
|
|
# $(1) = output directory
|
|
|
|
# $(2) = source file (%.c)
|
|
|
|
# $(3) = library name
|
|
|
|
define MAKE_C_LIB
|
|
|
|
$(eval OBJ := $(1)/$(patsubst %.c,%.o,$(notdir $(2))))
|
|
|
|
$(eval DEP := $(patsubst %.o,%.d,$(OBJ)))
|
|
|
|
|
|
|
|
$(OBJ): $(2) $(filter-out %.d,$(MAKEFILE_LIST)) | lib$(3)_dirs
|
Makefile: Support totally quiet output with -s
"-s" is a command line option to the make tool, to suppress normal output,
something to the effect of prepending every line with '@' in the Makefile.
However with our V={0|1} support, we now print the shortened command line
output in any case (even with V=1, in addition to the long line!).
Normally -s helps to not miss non-fatal warnings, which tend to scroll out
of the window easily.
Introduce a new Makefile variable ECHO, to control the shortened output.
We only set it in the (current default) V=0 case, and replace every
occurence of "@echo" with that variable.
When the user specifies "-s", we set ECHO to some magic string which
changes the output line into a comment, so the output is suppressed.
Beside suppressing every output for "-s", we also avoid the redundant
short output when compiling with V=1.
This changes the output to:
==========
$ make -s PLAT=.... bl31
Built build/.../release/bl31.bin
==========
$ make PLAT=.... bl31
...
CC lib/libc/strncmp.c
CC lib/libc/strnlen.c
...
==========
$ make V=1 PLAT=.... bl31
...
gcc -DDEBUG=0 .... -o build/.../release/libc/strncmp.o
gcc -DDEBUG=0 .... -o build/.../release/libc/strnlen.o
...
==========
Signed-off-by: Andre Przywara <andre.przywara@arm.com>
2018-09-27 09:56:05 +00:00
|
|
|
$$(ECHO) " CC $$<"
|
2018-05-08 09:27:10 +00:00
|
|
|
$$(Q)$$(CC) $$(TF_CFLAGS) $$(CFLAGS) $(MAKE_DEP) -c $$< -o $$@
|
|
|
|
|
|
|
|
-include $(DEP)
|
|
|
|
|
|
|
|
endef
|
|
|
|
|
2019-02-08 13:20:37 +00:00
|
|
|
# MAKE_S_LIB builds an assembly source file and generates the dependency file
|
|
|
|
# $(1) = output directory
|
|
|
|
# $(2) = source file (%.S)
|
|
|
|
# $(3) = library name
|
|
|
|
define MAKE_S_LIB
|
|
|
|
$(eval OBJ := $(1)/$(patsubst %.S,%.o,$(notdir $(2))))
|
|
|
|
$(eval DEP := $(patsubst %.o,%.d,$(OBJ)))
|
|
|
|
|
|
|
|
$(OBJ): $(2) $(filter-out %.d,$(MAKEFILE_LIST)) | lib$(3)_dirs
|
|
|
|
$$(ECHO) " AS $$<"
|
|
|
|
$$(Q)$$(AS) $$(ASFLAGS) $(MAKE_DEP) -c $$< -o $$@
|
|
|
|
|
|
|
|
-include $(DEP)
|
|
|
|
|
|
|
|
endef
|
|
|
|
|
2018-05-08 09:27:10 +00:00
|
|
|
|
2015-08-18 13:23:04 +00:00
|
|
|
# MAKE_C builds a C source file and generates the dependency file
|
|
|
|
# $(1) = output directory
|
|
|
|
# $(2) = source file (%.c)
|
2015-10-02 12:58:52 +00:00
|
|
|
# $(3) = BL stage (2, 2u, 30, 31, 32, 33)
|
2015-08-18 13:23:04 +00:00
|
|
|
define MAKE_C
|
|
|
|
|
|
|
|
$(eval OBJ := $(1)/$(patsubst %.c,%.o,$(notdir $(2))))
|
2016-12-22 05:02:27 +00:00
|
|
|
$(eval DEP := $(patsubst %.o,%.d,$(OBJ)))
|
2015-10-02 12:58:52 +00:00
|
|
|
$(eval IMAGE := IMAGE_BL$(call uppercase,$(3)))
|
2018-11-01 10:55:55 +00:00
|
|
|
$(eval BL_CFLAGS := $(BL$(call uppercase,$(3))_CFLAGS))
|
2015-08-18 13:23:04 +00:00
|
|
|
|
2018-02-22 00:13:50 +00:00
|
|
|
$(OBJ): $(2) $(filter-out %.d,$(MAKEFILE_LIST)) | bl$(3)_dirs
|
Makefile: Support totally quiet output with -s
"-s" is a command line option to the make tool, to suppress normal output,
something to the effect of prepending every line with '@' in the Makefile.
However with our V={0|1} support, we now print the shortened command line
output in any case (even with V=1, in addition to the long line!).
Normally -s helps to not miss non-fatal warnings, which tend to scroll out
of the window easily.
Introduce a new Makefile variable ECHO, to control the shortened output.
We only set it in the (current default) V=0 case, and replace every
occurence of "@echo" with that variable.
When the user specifies "-s", we set ECHO to some magic string which
changes the output line into a comment, so the output is suppressed.
Beside suppressing every output for "-s", we also avoid the redundant
short output when compiling with V=1.
This changes the output to:
==========
$ make -s PLAT=.... bl31
Built build/.../release/bl31.bin
==========
$ make PLAT=.... bl31
...
CC lib/libc/strncmp.c
CC lib/libc/strnlen.c
...
==========
$ make V=1 PLAT=.... bl31
...
gcc -DDEBUG=0 .... -o build/.../release/libc/strncmp.o
gcc -DDEBUG=0 .... -o build/.../release/libc/strnlen.o
...
==========
Signed-off-by: Andre Przywara <andre.przywara@arm.com>
2018-09-27 09:56:05 +00:00
|
|
|
$$(ECHO) " CC $$<"
|
2019-11-12 22:20:17 +00:00
|
|
|
$$(Q)$$(CC) $$(LTO_CFLAGS) $$(TF_CFLAGS) $$(CFLAGS) $(BL_CFLAGS) -D$(IMAGE) $(MAKE_DEP) -c $$< -o $$@
|
2015-08-18 13:23:04 +00:00
|
|
|
|
2016-12-22 05:02:27 +00:00
|
|
|
-include $(DEP)
|
2015-08-18 13:23:04 +00:00
|
|
|
|
|
|
|
endef
|
|
|
|
|
|
|
|
|
|
|
|
# MAKE_S builds an assembly source file and generates the dependency file
|
|
|
|
# $(1) = output directory
|
|
|
|
# $(2) = assembly file (%.S)
|
2015-10-02 12:58:52 +00:00
|
|
|
# $(3) = BL stage (2, 2u, 30, 31, 32, 33)
|
2015-08-18 13:23:04 +00:00
|
|
|
define MAKE_S
|
|
|
|
|
|
|
|
$(eval OBJ := $(1)/$(patsubst %.S,%.o,$(notdir $(2))))
|
2016-12-22 05:02:27 +00:00
|
|
|
$(eval DEP := $(patsubst %.o,%.d,$(OBJ)))
|
2015-10-02 12:58:52 +00:00
|
|
|
$(eval IMAGE := IMAGE_BL$(call uppercase,$(3)))
|
2015-08-18 13:23:04 +00:00
|
|
|
|
2018-02-22 00:13:50 +00:00
|
|
|
$(OBJ): $(2) $(filter-out %.d,$(MAKEFILE_LIST)) | bl$(3)_dirs
|
Makefile: Support totally quiet output with -s
"-s" is a command line option to the make tool, to suppress normal output,
something to the effect of prepending every line with '@' in the Makefile.
However with our V={0|1} support, we now print the shortened command line
output in any case (even with V=1, in addition to the long line!).
Normally -s helps to not miss non-fatal warnings, which tend to scroll out
of the window easily.
Introduce a new Makefile variable ECHO, to control the shortened output.
We only set it in the (current default) V=0 case, and replace every
occurence of "@echo" with that variable.
When the user specifies "-s", we set ECHO to some magic string which
changes the output line into a comment, so the output is suppressed.
Beside suppressing every output for "-s", we also avoid the redundant
short output when compiling with V=1.
This changes the output to:
==========
$ make -s PLAT=.... bl31
Built build/.../release/bl31.bin
==========
$ make PLAT=.... bl31
...
CC lib/libc/strncmp.c
CC lib/libc/strnlen.c
...
==========
$ make V=1 PLAT=.... bl31
...
gcc -DDEBUG=0 .... -o build/.../release/libc/strncmp.o
gcc -DDEBUG=0 .... -o build/.../release/libc/strnlen.o
...
==========
Signed-off-by: Andre Przywara <andre.przywara@arm.com>
2018-09-27 09:56:05 +00:00
|
|
|
$$(ECHO) " AS $$<"
|
2016-12-22 05:02:27 +00:00
|
|
|
$$(Q)$$(AS) $$(ASFLAGS) -D$(IMAGE) $(MAKE_DEP) -c $$< -o $$@
|
2015-08-18 13:23:04 +00:00
|
|
|
|
2016-12-22 05:02:27 +00:00
|
|
|
-include $(DEP)
|
2015-08-18 13:23:04 +00:00
|
|
|
|
|
|
|
endef
|
|
|
|
|
|
|
|
|
|
|
|
# MAKE_LD generate the linker script using the C preprocessor
|
|
|
|
# $(1) = output linker script
|
|
|
|
# $(2) = input template
|
2017-01-12 01:48:22 +00:00
|
|
|
# $(3) = BL stage (2, 2u, 30, 31, 32, 33)
|
2015-08-18 13:23:04 +00:00
|
|
|
define MAKE_LD
|
|
|
|
|
2016-12-22 05:02:27 +00:00
|
|
|
$(eval DEP := $(1).d)
|
2018-09-19 13:22:33 +00:00
|
|
|
$(eval IMAGE := IMAGE_BL$(call uppercase,$(3)))
|
2015-08-18 13:23:04 +00:00
|
|
|
|
2018-02-22 00:13:50 +00:00
|
|
|
$(1): $(2) $(filter-out %.d,$(MAKEFILE_LIST)) | bl$(3)_dirs
|
Makefile: Support totally quiet output with -s
"-s" is a command line option to the make tool, to suppress normal output,
something to the effect of prepending every line with '@' in the Makefile.
However with our V={0|1} support, we now print the shortened command line
output in any case (even with V=1, in addition to the long line!).
Normally -s helps to not miss non-fatal warnings, which tend to scroll out
of the window easily.
Introduce a new Makefile variable ECHO, to control the shortened output.
We only set it in the (current default) V=0 case, and replace every
occurence of "@echo" with that variable.
When the user specifies "-s", we set ECHO to some magic string which
changes the output line into a comment, so the output is suppressed.
Beside suppressing every output for "-s", we also avoid the redundant
short output when compiling with V=1.
This changes the output to:
==========
$ make -s PLAT=.... bl31
Built build/.../release/bl31.bin
==========
$ make PLAT=.... bl31
...
CC lib/libc/strncmp.c
CC lib/libc/strnlen.c
...
==========
$ make V=1 PLAT=.... bl31
...
gcc -DDEBUG=0 .... -o build/.../release/libc/strncmp.o
gcc -DDEBUG=0 .... -o build/.../release/libc/strnlen.o
...
==========
Signed-off-by: Andre Przywara <andre.przywara@arm.com>
2018-09-27 09:56:05 +00:00
|
|
|
$$(ECHO) " PP $$<"
|
2019-07-09 21:02:43 +00:00
|
|
|
$$(Q)$$(CPP) $$(CPPFLAGS) $(TF_CFLAGS_$(ARCH)) -P -x assembler-with-cpp -D__LINKER__ $(MAKE_DEP) -D$(IMAGE) -o $$@ $$<
|
2015-08-18 13:23:04 +00:00
|
|
|
|
2016-12-22 05:02:27 +00:00
|
|
|
-include $(DEP)
|
2015-08-18 13:23:04 +00:00
|
|
|
|
|
|
|
endef
|
|
|
|
|
2019-02-08 13:20:37 +00:00
|
|
|
# MAKE_LIB_OBJS builds both C and assembly source files
|
2018-05-08 09:27:10 +00:00
|
|
|
# $(1) = output directory
|
|
|
|
# $(2) = list of source files
|
|
|
|
# $(3) = name of the library
|
|
|
|
define MAKE_LIB_OBJS
|
|
|
|
$(eval C_OBJS := $(filter %.c,$(2)))
|
|
|
|
$(eval REMAIN := $(filter-out %.c,$(2)))
|
|
|
|
$(eval $(foreach obj,$(C_OBJS),$(call MAKE_C_LIB,$(1),$(obj),$(3))))
|
|
|
|
|
2019-02-08 13:20:37 +00:00
|
|
|
$(eval S_OBJS := $(filter %.S,$(REMAIN)))
|
|
|
|
$(eval REMAIN := $(filter-out %.S,$(REMAIN)))
|
|
|
|
$(eval $(foreach obj,$(S_OBJS),$(call MAKE_S_LIB,$(1),$(obj),$(3))))
|
|
|
|
|
2018-05-08 09:27:10 +00:00
|
|
|
$(and $(REMAIN),$(error Unexpected source files present: $(REMAIN)))
|
|
|
|
endef
|
|
|
|
|
2015-08-18 13:23:04 +00:00
|
|
|
|
|
|
|
# MAKE_OBJS builds both C and assembly source files
|
|
|
|
# $(1) = output directory
|
|
|
|
# $(2) = list of source files (both C and assembly)
|
|
|
|
# $(3) = BL stage (2, 30, 31, 32, 33)
|
|
|
|
define MAKE_OBJS
|
|
|
|
$(eval C_OBJS := $(filter %.c,$(2)))
|
|
|
|
$(eval REMAIN := $(filter-out %.c,$(2)))
|
|
|
|
$(eval $(foreach obj,$(C_OBJS),$(call MAKE_C,$(1),$(obj),$(3))))
|
|
|
|
|
|
|
|
$(eval S_OBJS := $(filter %.S,$(REMAIN)))
|
|
|
|
$(eval REMAIN := $(filter-out %.S,$(REMAIN)))
|
|
|
|
$(eval $(foreach obj,$(S_OBJS),$(call MAKE_S,$(1),$(obj),$(3))))
|
|
|
|
|
|
|
|
$(and $(REMAIN),$(error Unexpected source files present: $(REMAIN)))
|
|
|
|
endef
|
|
|
|
|
|
|
|
|
|
|
|
# NOTE: The line continuation '\' is required in the next define otherwise we
|
|
|
|
# end up with a line-feed characer at the end of the last c filename.
|
2015-12-02 18:56:06 +00:00
|
|
|
# Also bear this issue in mind if extending the list of supported filetypes.
|
2015-08-18 13:23:04 +00:00
|
|
|
define SOURCES_TO_OBJS
|
|
|
|
$(notdir $(patsubst %.c,%.o,$(filter %.c,$(1)))) \
|
|
|
|
$(notdir $(patsubst %.S,%.o,$(filter %.S,$(1))))
|
|
|
|
endef
|
|
|
|
|
2016-01-28 13:46:18 +00:00
|
|
|
# Allow overriding the timestamp, for example for reproducible builds, or to
|
|
|
|
# synchronize timestamps across multiple projects.
|
|
|
|
# This must be set to a C string (including quotes where applicable).
|
|
|
|
BUILD_MESSAGE_TIMESTAMP ?= __TIME__", "__DATE__
|
2015-08-18 13:23:04 +00:00
|
|
|
|
2018-05-08 09:27:10 +00:00
|
|
|
.PHONY: libraries
|
|
|
|
|
2018-05-22 15:05:42 +00:00
|
|
|
# MAKE_LIB_DIRS macro defines the target for the directory where
|
2018-05-08 09:27:10 +00:00
|
|
|
# libraries are created
|
2018-05-22 15:05:42 +00:00
|
|
|
define MAKE_LIB_DIRS
|
2018-05-08 09:27:10 +00:00
|
|
|
$(eval LIB_DIR := ${BUILD_PLAT}/lib)
|
2018-05-22 15:05:42 +00:00
|
|
|
$(eval ROMLIB_DIR := ${BUILD_PLAT}/romlib)
|
|
|
|
$(eval LIBWRAPPER_DIR := ${BUILD_PLAT}/libwrapper)
|
|
|
|
$(eval $(call MAKE_PREREQ_DIR,${LIB_DIR},${BUILD_PLAT}))
|
|
|
|
$(eval $(call MAKE_PREREQ_DIR,${ROMLIB_DIR},${BUILD_PLAT}))
|
|
|
|
$(eval $(call MAKE_PREREQ_DIR,${LIBWRAPPER_DIR},${BUILD_PLAT}))
|
2018-05-08 09:27:10 +00:00
|
|
|
endef
|
|
|
|
|
|
|
|
# MAKE_LIB macro defines the targets and options to build each BL image.
|
|
|
|
# Arguments:
|
|
|
|
# $(1) = Library name
|
|
|
|
define MAKE_LIB
|
|
|
|
$(eval BUILD_DIR := ${BUILD_PLAT}/lib$(1))
|
|
|
|
$(eval LIB_DIR := ${BUILD_PLAT}/lib)
|
2018-05-22 15:05:42 +00:00
|
|
|
$(eval ROMLIB_DIR := ${BUILD_PLAT}/romlib)
|
2018-05-08 09:27:10 +00:00
|
|
|
$(eval SOURCES := $(LIB$(call uppercase,$(1))_SRCS))
|
|
|
|
$(eval OBJS := $(addprefix $(BUILD_DIR)/,$(call SOURCES_TO_OBJS,$(SOURCES))))
|
|
|
|
|
|
|
|
$(eval $(call MAKE_PREREQ_DIR,${BUILD_DIR},${BUILD_PLAT}))
|
|
|
|
$(eval $(call MAKE_LIB_OBJS,$(BUILD_DIR),$(SOURCES),$(1)))
|
|
|
|
|
|
|
|
.PHONY : lib${1}_dirs
|
2018-05-22 15:05:42 +00:00
|
|
|
lib${1}_dirs: | ${BUILD_DIR} ${LIB_DIR} ${ROMLIB_DIR} ${LIBWRAPPER_DIR}
|
2018-05-08 09:27:10 +00:00
|
|
|
libraries: ${LIB_DIR}/lib$(1).a
|
2019-01-11 22:47:48 +00:00
|
|
|
ifneq ($(findstring armlink,$(notdir $(LD))),)
|
|
|
|
LDPATHS = --userlibpath=${LIB_DIR}
|
|
|
|
LDLIBS += --library=$(1)
|
|
|
|
else
|
2018-05-08 09:27:10 +00:00
|
|
|
LDPATHS = -L${LIB_DIR}
|
|
|
|
LDLIBS += -l$(1)
|
2019-01-11 22:47:48 +00:00
|
|
|
endif
|
2018-05-08 09:27:10 +00:00
|
|
|
|
2018-05-22 15:05:42 +00:00
|
|
|
ifeq ($(USE_ROMLIB),1)
|
2018-10-18 18:14:21 +00:00
|
|
|
LIBWRAPPER = -lwrappers
|
2018-05-22 15:05:42 +00:00
|
|
|
endif
|
|
|
|
|
2018-05-08 09:27:10 +00:00
|
|
|
all: ${LIB_DIR}/lib$(1).a
|
|
|
|
|
|
|
|
${LIB_DIR}/lib$(1).a: $(OBJS)
|
Makefile: Support totally quiet output with -s
"-s" is a command line option to the make tool, to suppress normal output,
something to the effect of prepending every line with '@' in the Makefile.
However with our V={0|1} support, we now print the shortened command line
output in any case (even with V=1, in addition to the long line!).
Normally -s helps to not miss non-fatal warnings, which tend to scroll out
of the window easily.
Introduce a new Makefile variable ECHO, to control the shortened output.
We only set it in the (current default) V=0 case, and replace every
occurence of "@echo" with that variable.
When the user specifies "-s", we set ECHO to some magic string which
changes the output line into a comment, so the output is suppressed.
Beside suppressing every output for "-s", we also avoid the redundant
short output when compiling with V=1.
This changes the output to:
==========
$ make -s PLAT=.... bl31
Built build/.../release/bl31.bin
==========
$ make PLAT=.... bl31
...
CC lib/libc/strncmp.c
CC lib/libc/strnlen.c
...
==========
$ make V=1 PLAT=.... bl31
...
gcc -DDEBUG=0 .... -o build/.../release/libc/strncmp.o
gcc -DDEBUG=0 .... -o build/.../release/libc/strnlen.o
...
==========
Signed-off-by: Andre Przywara <andre.przywara@arm.com>
2018-09-27 09:56:05 +00:00
|
|
|
$$(ECHO) " AR $$@"
|
2018-05-08 09:27:10 +00:00
|
|
|
$$(Q)$$(AR) cr $$@ $$?
|
|
|
|
endef
|
|
|
|
|
2015-08-18 13:23:04 +00:00
|
|
|
# MAKE_BL macro defines the targets and options to build each BL image.
|
|
|
|
# Arguments:
|
2015-10-02 12:58:52 +00:00
|
|
|
# $(1) = BL stage (2, 2u, 30, 31, 32, 33)
|
2016-01-05 11:55:36 +00:00
|
|
|
# $(2) = FIP command line option (if empty, image will not be included in the FIP)
|
2018-01-26 02:42:01 +00:00
|
|
|
# $(3) = FIP prefix (optional) (if FWU_, target is fwu_fip instead of fip)
|
2015-08-18 13:23:04 +00:00
|
|
|
define MAKE_BL
|
|
|
|
$(eval BUILD_DIR := ${BUILD_PLAT}/bl$(1))
|
2015-10-02 12:58:52 +00:00
|
|
|
$(eval BL_SOURCES := $(BL$(call uppercase,$(1))_SOURCES))
|
|
|
|
$(eval SOURCES := $(BL_SOURCES) $(BL_COMMON_SOURCES) $(PLAT_BL_COMMON_SOURCES))
|
2015-08-18 13:23:04 +00:00
|
|
|
$(eval OBJS := $(addprefix $(BUILD_DIR)/,$(call SOURCES_TO_OBJS,$(SOURCES))))
|
|
|
|
$(eval LINKERFILE := $(call IMG_LINKERFILE,$(1)))
|
|
|
|
$(eval MAPFILE := $(call IMG_MAPFILE,$(1)))
|
|
|
|
$(eval ELF := $(call IMG_ELF,$(1)))
|
|
|
|
$(eval DUMP := $(call IMG_DUMP,$(1)))
|
|
|
|
$(eval BIN := $(call IMG_BIN,$(1)))
|
2015-10-02 12:58:52 +00:00
|
|
|
$(eval BL_LINKERFILE := $(BL$(call uppercase,$(1))_LINKERFILE))
|
2018-06-21 10:40:33 +00:00
|
|
|
$(eval BL_LIBS := $(BL$(call uppercase,$(1))_LIBS))
|
2015-12-03 12:19:30 +00:00
|
|
|
# We use sort only to get a list of unique object directory names.
|
|
|
|
# ordering is not relevant but sort removes duplicates.
|
2017-04-07 15:58:57 +00:00
|
|
|
$(eval TEMP_OBJ_DIRS := $(sort $(dir ${OBJS} ${LINKERFILE})))
|
2015-12-03 12:19:30 +00:00
|
|
|
# The $(dir ) function leaves a trailing / on the directory names
|
2017-01-19 10:31:00 +00:00
|
|
|
# Rip off the / to match directory names with make rule targets.
|
|
|
|
$(eval OBJ_DIRS := $(patsubst %/,%,$(TEMP_OBJ_DIRS)))
|
2015-12-03 12:19:30 +00:00
|
|
|
|
|
|
|
# Create generators for object directory structure
|
|
|
|
|
2017-11-03 18:12:28 +00:00
|
|
|
$(eval $(call MAKE_PREREQ_DIR,${BUILD_DIR},${BUILD_PLAT}))
|
2017-04-07 15:58:57 +00:00
|
|
|
|
|
|
|
$(eval $(foreach objd,${OBJ_DIRS},$(call MAKE_PREREQ_DIR,${objd},${BUILD_DIR})))
|
2015-12-03 12:19:30 +00:00
|
|
|
|
|
|
|
.PHONY : bl${1}_dirs
|
2015-08-18 13:23:04 +00:00
|
|
|
|
2015-12-03 12:19:30 +00:00
|
|
|
# We use order-only prerequisites to ensure that directories are created,
|
|
|
|
# but do not cause re-builds every time a file is written.
|
|
|
|
bl${1}_dirs: | ${OBJ_DIRS}
|
2015-08-18 13:23:04 +00:00
|
|
|
|
2015-12-03 12:19:30 +00:00
|
|
|
$(eval $(call MAKE_OBJS,$(BUILD_DIR),$(SOURCES),$(1)))
|
2017-01-12 01:48:22 +00:00
|
|
|
$(eval $(call MAKE_LD,$(LINKERFILE),$(BL_LINKERFILE),$(1)))
|
2015-08-18 13:23:04 +00:00
|
|
|
|
2018-05-22 15:05:42 +00:00
|
|
|
ifeq ($(USE_ROMLIB),1)
|
|
|
|
$(ELF): romlib.bin
|
|
|
|
endif
|
|
|
|
|
2018-05-08 09:27:10 +00:00
|
|
|
$(ELF): $(OBJS) $(LINKERFILE) | bl$(1)_dirs libraries $(BL_LIBS)
|
Makefile: Support totally quiet output with -s
"-s" is a command line option to the make tool, to suppress normal output,
something to the effect of prepending every line with '@' in the Makefile.
However with our V={0|1} support, we now print the shortened command line
output in any case (even with V=1, in addition to the long line!).
Normally -s helps to not miss non-fatal warnings, which tend to scroll out
of the window easily.
Introduce a new Makefile variable ECHO, to control the shortened output.
We only set it in the (current default) V=0 case, and replace every
occurence of "@echo" with that variable.
When the user specifies "-s", we set ECHO to some magic string which
changes the output line into a comment, so the output is suppressed.
Beside suppressing every output for "-s", we also avoid the redundant
short output when compiling with V=1.
This changes the output to:
==========
$ make -s PLAT=.... bl31
Built build/.../release/bl31.bin
==========
$ make PLAT=.... bl31
...
CC lib/libc/strncmp.c
CC lib/libc/strnlen.c
...
==========
$ make V=1 PLAT=.... bl31
...
gcc -DDEBUG=0 .... -o build/.../release/libc/strncmp.o
gcc -DDEBUG=0 .... -o build/.../release/libc/strnlen.o
...
==========
Signed-off-by: Andre Przywara <andre.przywara@arm.com>
2018-09-27 09:56:05 +00:00
|
|
|
$$(ECHO) " LD $$@"
|
2015-12-03 12:58:52 +00:00
|
|
|
ifdef MAKE_BUILD_STRINGS
|
|
|
|
$(call MAKE_BUILD_STRINGS, $(BUILD_DIR)/build_message.o)
|
|
|
|
else
|
2016-01-28 13:46:18 +00:00
|
|
|
@echo 'const char build_message[] = "Built : "$(BUILD_MESSAGE_TIMESTAMP); \
|
2015-08-18 13:23:04 +00:00
|
|
|
const char version_string[] = "${VERSION_STRING}";' | \
|
2016-12-22 03:39:55 +00:00
|
|
|
$$(CC) $$(TF_CFLAGS) $$(CFLAGS) -xc -c - -o $(BUILD_DIR)/build_message.o
|
2015-12-03 12:58:52 +00:00
|
|
|
endif
|
2019-01-11 22:47:48 +00:00
|
|
|
ifneq ($(findstring armlink,$(notdir $(LD))),)
|
|
|
|
$$(Q)$$(LD) -o $$@ $$(TF_LDFLAGS) $$(LDFLAGS) --entry=bl${1}_entrypoint \
|
|
|
|
--predefine="-D__LINKER__=$(__LINKER__)" \
|
|
|
|
--predefine="-DTF_CFLAGS=$(TF_CFLAGS)" \
|
|
|
|
--map --list="$(MAPFILE)" --scatter=${PLAT_DIR}/scat/bl${1}.scat \
|
|
|
|
$(LDPATHS) $(LIBWRAPPER) $(LDLIBS) $(BL_LIBS) \
|
|
|
|
$(BUILD_DIR)/build_message.o $(OBJS)
|
2019-11-12 22:20:17 +00:00
|
|
|
else ifneq ($(findstring gcc,$(notdir $(LD))),)
|
|
|
|
$$(Q)$$(LD) -o $$@ $$(TF_LDFLAGS) $$(LDFLAGS) -Wl,-Map=$(MAPFILE) \
|
|
|
|
-Wl,-T$(LINKERFILE) $(BUILD_DIR)/build_message.o \
|
|
|
|
$(OBJS) $(LDPATHS) $(LIBWRAPPER) $(LDLIBS) $(BL_LIBS)
|
2019-01-11 22:47:48 +00:00
|
|
|
else
|
2017-06-22 13:44:48 +00:00
|
|
|
$$(Q)$$(LD) -o $$@ $$(TF_LDFLAGS) $$(LDFLAGS) -Map=$(MAPFILE) \
|
2018-05-08 09:27:10 +00:00
|
|
|
--script $(LINKERFILE) $(BUILD_DIR)/build_message.o \
|
2018-10-18 18:14:21 +00:00
|
|
|
$(OBJS) $(LDPATHS) $(LIBWRAPPER) $(LDLIBS) $(BL_LIBS)
|
2019-01-11 22:47:48 +00:00
|
|
|
endif
|
2019-04-24 07:45:30 +00:00
|
|
|
ifeq ($(DISABLE_BIN_GENERATION),1)
|
|
|
|
@${ECHO_BLANK_LINE}
|
|
|
|
@echo "Built $$@ successfully"
|
|
|
|
@${ECHO_BLANK_LINE}
|
|
|
|
endif
|
2015-08-18 13:23:04 +00:00
|
|
|
|
|
|
|
$(DUMP): $(ELF)
|
Makefile: Support totally quiet output with -s
"-s" is a command line option to the make tool, to suppress normal output,
something to the effect of prepending every line with '@' in the Makefile.
However with our V={0|1} support, we now print the shortened command line
output in any case (even with V=1, in addition to the long line!).
Normally -s helps to not miss non-fatal warnings, which tend to scroll out
of the window easily.
Introduce a new Makefile variable ECHO, to control the shortened output.
We only set it in the (current default) V=0 case, and replace every
occurence of "@echo" with that variable.
When the user specifies "-s", we set ECHO to some magic string which
changes the output line into a comment, so the output is suppressed.
Beside suppressing every output for "-s", we also avoid the redundant
short output when compiling with V=1.
This changes the output to:
==========
$ make -s PLAT=.... bl31
Built build/.../release/bl31.bin
==========
$ make PLAT=.... bl31
...
CC lib/libc/strncmp.c
CC lib/libc/strnlen.c
...
==========
$ make V=1 PLAT=.... bl31
...
gcc -DDEBUG=0 .... -o build/.../release/libc/strncmp.o
gcc -DDEBUG=0 .... -o build/.../release/libc/strnlen.o
...
==========
Signed-off-by: Andre Przywara <andre.przywara@arm.com>
2018-09-27 09:56:05 +00:00
|
|
|
$${ECHO} " OD $$@"
|
2015-08-18 13:23:04 +00:00
|
|
|
$${Q}$${OD} -dx $$< > $$@
|
|
|
|
|
|
|
|
$(BIN): $(ELF)
|
Makefile: Support totally quiet output with -s
"-s" is a command line option to the make tool, to suppress normal output,
something to the effect of prepending every line with '@' in the Makefile.
However with our V={0|1} support, we now print the shortened command line
output in any case (even with V=1, in addition to the long line!).
Normally -s helps to not miss non-fatal warnings, which tend to scroll out
of the window easily.
Introduce a new Makefile variable ECHO, to control the shortened output.
We only set it in the (current default) V=0 case, and replace every
occurence of "@echo" with that variable.
When the user specifies "-s", we set ECHO to some magic string which
changes the output line into a comment, so the output is suppressed.
Beside suppressing every output for "-s", we also avoid the redundant
short output when compiling with V=1.
This changes the output to:
==========
$ make -s PLAT=.... bl31
Built build/.../release/bl31.bin
==========
$ make PLAT=.... bl31
...
CC lib/libc/strncmp.c
CC lib/libc/strnlen.c
...
==========
$ make V=1 PLAT=.... bl31
...
gcc -DDEBUG=0 .... -o build/.../release/libc/strncmp.o
gcc -DDEBUG=0 .... -o build/.../release/libc/strnlen.o
...
==========
Signed-off-by: Andre Przywara <andre.przywara@arm.com>
2018-09-27 09:56:05 +00:00
|
|
|
$${ECHO} " BIN $$@"
|
2015-08-18 13:23:04 +00:00
|
|
|
$$(Q)$$(OC) -O binary $$< $$@
|
2017-04-11 15:52:00 +00:00
|
|
|
@${ECHO_BLANK_LINE}
|
2015-08-18 13:23:04 +00:00
|
|
|
@echo "Built $$@ successfully"
|
2017-04-11 15:52:00 +00:00
|
|
|
@${ECHO_BLANK_LINE}
|
2015-08-18 13:23:04 +00:00
|
|
|
|
|
|
|
.PHONY: bl$(1)
|
2019-04-24 07:45:30 +00:00
|
|
|
ifeq ($(DISABLE_BIN_GENERATION),1)
|
|
|
|
bl$(1): $(ELF) $(DUMP)
|
|
|
|
else
|
2015-12-03 12:19:30 +00:00
|
|
|
bl$(1): $(BIN) $(DUMP)
|
2019-04-24 07:45:30 +00:00
|
|
|
endif
|
2015-08-18 13:23:04 +00:00
|
|
|
|
|
|
|
all: bl$(1)
|
|
|
|
|
Build: support pre-tool image processing
There are cases where we want to process images before they are
passed to cert_create / fiptool.
My main motivation is data compression. By compressing images, we can
save data storage, and possibly speed up loading images. The image
verification will also get faster because certificates are generated
based on compressed images.
Other image transformation filters (for ex. encryption), and their
combinations would be possible. So, our build system should support
transformation filters in a generic manner.
The choice of applied filters is up to platforms (so specified in
platform.mk)
To define a new filter, <FILTER_NAME>_RULE and <FILTER_NAME>_SUFFIX
are needed.
For example, the GZIP compression filter can be implemented as follows:
------------------------>8------------------------
define GZIP_RULE
$(1): $(2)
@echo " GZIP $$@"
$(Q)gzip -n -f -9 $$< --stdout > $$@
endef
GZIP_SUFFIX := .gz
------------------------>8------------------------
The _RULE defines how to create the target $(1) from the source $(2).
The _SUFFIX defines the extension appended to the processed image path.
The suffix is not so important because the file name information is not
propagated to FIP, but adding a sensible suffix will be good to classify
the data file.
Platforms can specify which filter is applied to which BL image, like
this:
------------------------>8------------------------
BL32_PRE_TOOL_FILTER := GZIP
BL33_PRE_TOOL_FILTER := GZIP
------------------------>8------------------------
<IMAGE_NAME>_PRE_TOOL_FILTER specifies per-image filter. With this,
different images can be transformed differently. For the case above,
only BL32 and BL33 are GZIP-compressed. Nothing is done for other
images.
Signed-off-by: Masahiro Yamada <yamada.masahiro@socionext.com>
2018-02-01 07:31:09 +00:00
|
|
|
$(if $(2),$(call TOOL_ADD_IMG_PAYLOAD,bl$(1),$(BIN),--$(2),$(BIN),$(3)))
|
2015-08-18 13:23:04 +00:00
|
|
|
|
|
|
|
endef
|
|
|
|
|
2017-12-14 17:44:56 +00:00
|
|
|
# Convert device tree source file names to matching blobs
|
|
|
|
# $(1) = input dts
|
Makefile: Add ability to build dtb
This is a revamp of the original approach in:
https://github.com/ARM-software/arm-trusted-firmware/pull/747
Current build system has no means to automatically generate dtbs from
dts, instead, stores the dtbs in the fdts/ folder. While this makes
perfect sense for many reference platforms, this becomes a minor
breakage in development flow for newer platforms.
However, this can be solved by providing a rule for the dtbs while
building the ATF binaries by purely describing which dts sources we
need.
For example, with this change, we will now be able to describe the
dtbs we need for the platform in the corresponding platform.mk file:
FDT_SOURCES += fdts/abc.dts
This should be able to generate the abc.dtb appropriately.
Since device trees are specification of hardware, we don't tie the rule
to any specific BL, instead a generic rule is introduced.
Further, this approach allows us to generate appropriate dtbs which may be
need to be regenerated when a common dtsi gets updated, by just
restricting changes to the dtsi alone, instead of synchronizing all the
dtbs as well.
If dtc is not available in default paths, but is available in an
alternate location, it can be chosen by overriding the DTC variable
such as 'make DTC=~/dtc/dtc ....`
NOTE: dtbs are built only with the explicit make dtbs command. The rule
is only available if the platform defines a FDT_SOURCES variable.
Signed-off-by: Benjamin Fair <b-fair@ti.com>
Signed-off-by: Nishanth Menon <nm@ti.com>
2016-10-14 01:13:57 +00:00
|
|
|
define SOURCES_TO_DTBS
|
|
|
|
$(notdir $(patsubst %.dts,%.dtb,$(filter %.dts,$(1))))
|
|
|
|
endef
|
|
|
|
|
2017-12-14 17:44:56 +00:00
|
|
|
# MAKE_FDT_DIRS macro creates the prerequisite directories that host the
|
|
|
|
# FDT binaries
|
|
|
|
# $(1) = output directory
|
|
|
|
# $(2) = input dts
|
|
|
|
define MAKE_FDT_DIRS
|
|
|
|
$(eval DTBS := $(addprefix $(1)/,$(call SOURCES_TO_DTBS,$(2))))
|
Makefile: Add ability to build dtb
This is a revamp of the original approach in:
https://github.com/ARM-software/arm-trusted-firmware/pull/747
Current build system has no means to automatically generate dtbs from
dts, instead, stores the dtbs in the fdts/ folder. While this makes
perfect sense for many reference platforms, this becomes a minor
breakage in development flow for newer platforms.
However, this can be solved by providing a rule for the dtbs while
building the ATF binaries by purely describing which dts sources we
need.
For example, with this change, we will now be able to describe the
dtbs we need for the platform in the corresponding platform.mk file:
FDT_SOURCES += fdts/abc.dts
This should be able to generate the abc.dtb appropriately.
Since device trees are specification of hardware, we don't tie the rule
to any specific BL, instead a generic rule is introduced.
Further, this approach allows us to generate appropriate dtbs which may be
need to be regenerated when a common dtsi gets updated, by just
restricting changes to the dtsi alone, instead of synchronizing all the
dtbs as well.
If dtc is not available in default paths, but is available in an
alternate location, it can be chosen by overriding the DTC variable
such as 'make DTC=~/dtc/dtc ....`
NOTE: dtbs are built only with the explicit make dtbs command. The rule
is only available if the platform defines a FDT_SOURCES variable.
Signed-off-by: Benjamin Fair <b-fair@ti.com>
Signed-off-by: Nishanth Menon <nm@ti.com>
2016-10-14 01:13:57 +00:00
|
|
|
$(eval TEMP_DTB_DIRS := $(sort $(dir ${DTBS})))
|
|
|
|
# The $(dir ) function leaves a trailing / on the directory names
|
|
|
|
# Rip off the / to match directory names with make rule targets.
|
|
|
|
$(eval DTB_DIRS := $(patsubst %/,%,$(TEMP_DTB_DIRS)))
|
|
|
|
|
|
|
|
$(eval $(foreach objd,${DTB_DIRS},$(call MAKE_PREREQ_DIR,${objd},${BUILD_DIR})))
|
|
|
|
|
|
|
|
fdt_dirs: ${DTB_DIRS}
|
|
|
|
endef
|
|
|
|
|
2017-12-14 17:44:56 +00:00
|
|
|
# MAKE_DTB generate the Flattened device tree binary
|
Makefile: Add ability to build dtb
This is a revamp of the original approach in:
https://github.com/ARM-software/arm-trusted-firmware/pull/747
Current build system has no means to automatically generate dtbs from
dts, instead, stores the dtbs in the fdts/ folder. While this makes
perfect sense for many reference platforms, this becomes a minor
breakage in development flow for newer platforms.
However, this can be solved by providing a rule for the dtbs while
building the ATF binaries by purely describing which dts sources we
need.
For example, with this change, we will now be able to describe the
dtbs we need for the platform in the corresponding platform.mk file:
FDT_SOURCES += fdts/abc.dts
This should be able to generate the abc.dtb appropriately.
Since device trees are specification of hardware, we don't tie the rule
to any specific BL, instead a generic rule is introduced.
Further, this approach allows us to generate appropriate dtbs which may be
need to be regenerated when a common dtsi gets updated, by just
restricting changes to the dtsi alone, instead of synchronizing all the
dtbs as well.
If dtc is not available in default paths, but is available in an
alternate location, it can be chosen by overriding the DTC variable
such as 'make DTC=~/dtc/dtc ....`
NOTE: dtbs are built only with the explicit make dtbs command. The rule
is only available if the platform defines a FDT_SOURCES variable.
Signed-off-by: Benjamin Fair <b-fair@ti.com>
Signed-off-by: Nishanth Menon <nm@ti.com>
2016-10-14 01:13:57 +00:00
|
|
|
# $(1) = output directory
|
|
|
|
# $(2) = input dts
|
|
|
|
define MAKE_DTB
|
|
|
|
|
2018-09-04 08:44:00 +00:00
|
|
|
# List of DTB file(s) to generate, based on DTS file basename list
|
2017-12-14 17:44:56 +00:00
|
|
|
$(eval DOBJ := $(addprefix $(1)/,$(call SOURCES_TO_DTBS,$(2))))
|
2018-09-04 08:44:00 +00:00
|
|
|
# List of the pre-compiled DTS file(s)
|
2018-06-18 14:00:23 +00:00
|
|
|
$(eval DPRE := $(addprefix $(1)/,$(patsubst %.dts,%.pre.dts,$(notdir $(2)))))
|
2018-09-04 08:44:00 +00:00
|
|
|
# Dependencies of the pre-compiled DTS file(s) on its source and included files
|
|
|
|
$(eval DTSDEP := $(patsubst %.dtb,%.o.d,$(DOBJ)))
|
|
|
|
# Dependencies of the DT compilation on its pre-compiled DTS
|
|
|
|
$(eval DTBDEP := $(patsubst %.dtb,%.d,$(DOBJ)))
|
Makefile: Add ability to build dtb
This is a revamp of the original approach in:
https://github.com/ARM-software/arm-trusted-firmware/pull/747
Current build system has no means to automatically generate dtbs from
dts, instead, stores the dtbs in the fdts/ folder. While this makes
perfect sense for many reference platforms, this becomes a minor
breakage in development flow for newer platforms.
However, this can be solved by providing a rule for the dtbs while
building the ATF binaries by purely describing which dts sources we
need.
For example, with this change, we will now be able to describe the
dtbs we need for the platform in the corresponding platform.mk file:
FDT_SOURCES += fdts/abc.dts
This should be able to generate the abc.dtb appropriately.
Since device trees are specification of hardware, we don't tie the rule
to any specific BL, instead a generic rule is introduced.
Further, this approach allows us to generate appropriate dtbs which may be
need to be regenerated when a common dtsi gets updated, by just
restricting changes to the dtsi alone, instead of synchronizing all the
dtbs as well.
If dtc is not available in default paths, but is available in an
alternate location, it can be chosen by overriding the DTC variable
such as 'make DTC=~/dtc/dtc ....`
NOTE: dtbs are built only with the explicit make dtbs command. The rule
is only available if the platform defines a FDT_SOURCES variable.
Signed-off-by: Benjamin Fair <b-fair@ti.com>
Signed-off-by: Nishanth Menon <nm@ti.com>
2016-10-14 01:13:57 +00:00
|
|
|
|
2018-02-22 00:13:50 +00:00
|
|
|
$(DOBJ): $(2) $(filter-out %.d,$(MAKEFILE_LIST)) | fdt_dirs
|
Makefile: Support totally quiet output with -s
"-s" is a command line option to the make tool, to suppress normal output,
something to the effect of prepending every line with '@' in the Makefile.
However with our V={0|1} support, we now print the shortened command line
output in any case (even with V=1, in addition to the long line!).
Normally -s helps to not miss non-fatal warnings, which tend to scroll out
of the window easily.
Introduce a new Makefile variable ECHO, to control the shortened output.
We only set it in the (current default) V=0 case, and replace every
occurence of "@echo" with that variable.
When the user specifies "-s", we set ECHO to some magic string which
changes the output line into a comment, so the output is suppressed.
Beside suppressing every output for "-s", we also avoid the redundant
short output when compiling with V=1.
This changes the output to:
==========
$ make -s PLAT=.... bl31
Built build/.../release/bl31.bin
==========
$ make PLAT=.... bl31
...
CC lib/libc/strncmp.c
CC lib/libc/strnlen.c
...
==========
$ make V=1 PLAT=.... bl31
...
gcc -DDEBUG=0 .... -o build/.../release/libc/strncmp.o
gcc -DDEBUG=0 .... -o build/.../release/libc/strnlen.o
...
==========
Signed-off-by: Andre Przywara <andre.przywara@arm.com>
2018-09-27 09:56:05 +00:00
|
|
|
$${ECHO} " CPP $$<"
|
2018-09-04 08:44:00 +00:00
|
|
|
$(eval DTBS := $(addprefix $(1)/,$(call SOURCES_TO_DTBS,$(2))))
|
2019-01-21 14:50:10 +00:00
|
|
|
$$(Q)$$(PP) $$(DTC_CPPFLAGS) -MT $(DTBS) -MMD -MF $(DTSDEP) -o $(DPRE) $$<
|
Makefile: Support totally quiet output with -s
"-s" is a command line option to the make tool, to suppress normal output,
something to the effect of prepending every line with '@' in the Makefile.
However with our V={0|1} support, we now print the shortened command line
output in any case (even with V=1, in addition to the long line!).
Normally -s helps to not miss non-fatal warnings, which tend to scroll out
of the window easily.
Introduce a new Makefile variable ECHO, to control the shortened output.
We only set it in the (current default) V=0 case, and replace every
occurence of "@echo" with that variable.
When the user specifies "-s", we set ECHO to some magic string which
changes the output line into a comment, so the output is suppressed.
Beside suppressing every output for "-s", we also avoid the redundant
short output when compiling with V=1.
This changes the output to:
==========
$ make -s PLAT=.... bl31
Built build/.../release/bl31.bin
==========
$ make PLAT=.... bl31
...
CC lib/libc/strncmp.c
CC lib/libc/strnlen.c
...
==========
$ make V=1 PLAT=.... bl31
...
gcc -DDEBUG=0 .... -o build/.../release/libc/strncmp.o
gcc -DDEBUG=0 .... -o build/.../release/libc/strnlen.o
...
==========
Signed-off-by: Andre Przywara <andre.przywara@arm.com>
2018-09-27 09:56:05 +00:00
|
|
|
$${ECHO} " DTC $$<"
|
2018-09-04 08:44:00 +00:00
|
|
|
$$(Q)$$(DTC) $$(DTC_FLAGS) -i fdts -d $(DTBDEP) -o $$@ $(DPRE)
|
Makefile: Add ability to build dtb
This is a revamp of the original approach in:
https://github.com/ARM-software/arm-trusted-firmware/pull/747
Current build system has no means to automatically generate dtbs from
dts, instead, stores the dtbs in the fdts/ folder. While this makes
perfect sense for many reference platforms, this becomes a minor
breakage in development flow for newer platforms.
However, this can be solved by providing a rule for the dtbs while
building the ATF binaries by purely describing which dts sources we
need.
For example, with this change, we will now be able to describe the
dtbs we need for the platform in the corresponding platform.mk file:
FDT_SOURCES += fdts/abc.dts
This should be able to generate the abc.dtb appropriately.
Since device trees are specification of hardware, we don't tie the rule
to any specific BL, instead a generic rule is introduced.
Further, this approach allows us to generate appropriate dtbs which may be
need to be regenerated when a common dtsi gets updated, by just
restricting changes to the dtsi alone, instead of synchronizing all the
dtbs as well.
If dtc is not available in default paths, but is available in an
alternate location, it can be chosen by overriding the DTC variable
such as 'make DTC=~/dtc/dtc ....`
NOTE: dtbs are built only with the explicit make dtbs command. The rule
is only available if the platform defines a FDT_SOURCES variable.
Signed-off-by: Benjamin Fair <b-fair@ti.com>
Signed-off-by: Nishanth Menon <nm@ti.com>
2016-10-14 01:13:57 +00:00
|
|
|
|
2018-09-04 08:44:00 +00:00
|
|
|
-include $(DTBDEP)
|
|
|
|
-include $(DTSDEP)
|
Makefile: Add ability to build dtb
This is a revamp of the original approach in:
https://github.com/ARM-software/arm-trusted-firmware/pull/747
Current build system has no means to automatically generate dtbs from
dts, instead, stores the dtbs in the fdts/ folder. While this makes
perfect sense for many reference platforms, this becomes a minor
breakage in development flow for newer platforms.
However, this can be solved by providing a rule for the dtbs while
building the ATF binaries by purely describing which dts sources we
need.
For example, with this change, we will now be able to describe the
dtbs we need for the platform in the corresponding platform.mk file:
FDT_SOURCES += fdts/abc.dts
This should be able to generate the abc.dtb appropriately.
Since device trees are specification of hardware, we don't tie the rule
to any specific BL, instead a generic rule is introduced.
Further, this approach allows us to generate appropriate dtbs which may be
need to be regenerated when a common dtsi gets updated, by just
restricting changes to the dtsi alone, instead of synchronizing all the
dtbs as well.
If dtc is not available in default paths, but is available in an
alternate location, it can be chosen by overriding the DTC variable
such as 'make DTC=~/dtc/dtc ....`
NOTE: dtbs are built only with the explicit make dtbs command. The rule
is only available if the platform defines a FDT_SOURCES variable.
Signed-off-by: Benjamin Fair <b-fair@ti.com>
Signed-off-by: Nishanth Menon <nm@ti.com>
2016-10-14 01:13:57 +00:00
|
|
|
|
|
|
|
endef
|
|
|
|
|
|
|
|
# MAKE_DTBS builds flattened device tree sources
|
|
|
|
# $(1) = output directory
|
|
|
|
# $(2) = list of flattened device tree source files
|
|
|
|
define MAKE_DTBS
|
|
|
|
$(eval DOBJS := $(filter %.dts,$(2)))
|
|
|
|
$(eval REMAIN := $(filter-out %.dts,$(2)))
|
2017-12-14 17:44:56 +00:00
|
|
|
$(and $(REMAIN),$(error FDT_SOURCES contain non-DTS files: $(REMAIN)))
|
Makefile: Add ability to build dtb
This is a revamp of the original approach in:
https://github.com/ARM-software/arm-trusted-firmware/pull/747
Current build system has no means to automatically generate dtbs from
dts, instead, stores the dtbs in the fdts/ folder. While this makes
perfect sense for many reference platforms, this becomes a minor
breakage in development flow for newer platforms.
However, this can be solved by providing a rule for the dtbs while
building the ATF binaries by purely describing which dts sources we
need.
For example, with this change, we will now be able to describe the
dtbs we need for the platform in the corresponding platform.mk file:
FDT_SOURCES += fdts/abc.dts
This should be able to generate the abc.dtb appropriately.
Since device trees are specification of hardware, we don't tie the rule
to any specific BL, instead a generic rule is introduced.
Further, this approach allows us to generate appropriate dtbs which may be
need to be regenerated when a common dtsi gets updated, by just
restricting changes to the dtsi alone, instead of synchronizing all the
dtbs as well.
If dtc is not available in default paths, but is available in an
alternate location, it can be chosen by overriding the DTC variable
such as 'make DTC=~/dtc/dtc ....`
NOTE: dtbs are built only with the explicit make dtbs command. The rule
is only available if the platform defines a FDT_SOURCES variable.
Signed-off-by: Benjamin Fair <b-fair@ti.com>
Signed-off-by: Nishanth Menon <nm@ti.com>
2016-10-14 01:13:57 +00:00
|
|
|
$(eval $(foreach obj,$(DOBJS),$(call MAKE_DTB,$(1),$(obj))))
|
|
|
|
|
2017-12-14 17:44:56 +00:00
|
|
|
$(eval $(call MAKE_FDT_DIRS,$(1),$(2)))
|
|
|
|
|
|
|
|
dtbs: $(DTBS)
|
|
|
|
all: dtbs
|
Makefile: Add ability to build dtb
This is a revamp of the original approach in:
https://github.com/ARM-software/arm-trusted-firmware/pull/747
Current build system has no means to automatically generate dtbs from
dts, instead, stores the dtbs in the fdts/ folder. While this makes
perfect sense for many reference platforms, this becomes a minor
breakage in development flow for newer platforms.
However, this can be solved by providing a rule for the dtbs while
building the ATF binaries by purely describing which dts sources we
need.
For example, with this change, we will now be able to describe the
dtbs we need for the platform in the corresponding platform.mk file:
FDT_SOURCES += fdts/abc.dts
This should be able to generate the abc.dtb appropriately.
Since device trees are specification of hardware, we don't tie the rule
to any specific BL, instead a generic rule is introduced.
Further, this approach allows us to generate appropriate dtbs which may be
need to be regenerated when a common dtsi gets updated, by just
restricting changes to the dtsi alone, instead of synchronizing all the
dtbs as well.
If dtc is not available in default paths, but is available in an
alternate location, it can be chosen by overriding the DTC variable
such as 'make DTC=~/dtc/dtc ....`
NOTE: dtbs are built only with the explicit make dtbs command. The rule
is only available if the platform defines a FDT_SOURCES variable.
Signed-off-by: Benjamin Fair <b-fair@ti.com>
Signed-off-by: Nishanth Menon <nm@ti.com>
2016-10-14 01:13:57 +00:00
|
|
|
endef
|