granicus.if.org Git - esp-idf/blob - make/common.mk

   1 # Functionality common to both top-level project makefile (project.mk)
   2 # and component makefiles (component_wrapper.mk)
   3 #
   4
   5 # Include project config makefile, if it exists.
   6 #
   7 # (Note that we only rebuild this makefile automatically for some
   8 # targets, see project_config.mk for details.)
   9 SDKCONFIG_MAKEFILE ?= $(abspath $(BUILD_DIR_BASE)/include/config/auto.conf)
  10 -include $(SDKCONFIG_MAKEFILE)
  11 export SDKCONFIG_MAKEFILE  # sub-makes (like bootloader) will reuse this path
  12
  13 # BATCH_BUILD flag disables interactive terminal features, defaults to verbose build
  14 ifdef BATCH_BUILD
  15 V ?= 1
  16 endif
  17
  18 #Handling of V=1/VERBOSE=1 flag
  19 #
  20 # if V=1, $(summary) does nothing and $(details) will echo extra details
  21 # if V is unset or not 1, $(summary) echoes a summary and $(details) does nothing
  22 VERBOSE ?=
  23 V ?= $(VERBOSE)
  24 ifeq ("$(V)","1")
  25 summary := @true
  26 details := @echo
  27 else
  28 summary := @echo
  29 details := @true
  30
  31 # disable echoing of commands, directory names
  32 MAKEFLAGS += --silent
  33 endif  # $(V)==1
  34
  35 ifdef CONFIG_MAKE_WARN_UNDEFINED_VARIABLES
  36 MAKEFLAGS += --warn-undefined-variables
  37 endif
  38
  39 # General make utilities
  40
  41 # convenience variable for printing an 80 asterisk wide separator line
  42 SEPARATOR:="*******************************************************************************"
  43
  44 # macro to remove quotes from an argument, ie $(call dequote,$(CONFIG_BLAH))
  45 define dequote
  46 $(subst ",,$(1))
  47 endef
  48 # " comment kept here to keep syntax highlighting happy
  49
  50
  51 # macro to keep an absolute path as-is, but resolve a relative path
  52 # against a particular parent directory
  53 #
  54 # $(1) path to resolve
  55 # $(2) directory to resolve non-absolute path against
  56 #
  57 # Path and directory don't have to exist (definition of a "relative
  58 # path" is one that doesn't start with /)
  59 #
  60 # $(2) can contain a trailing forward slash or not, result will not
  61 # double any path slashes.
  62 #
  63 # example $(call resolvepath,$(CONFIG_PATH),$(CONFIG_DIR))
  64 define resolvepath
  65 $(abspath $(foreach dir,$(1),$(if $(filter /%,$(dir)),$(dir),$(subst //,/,$(2)/$(dir)))))
  66 endef
  67
  68
  69 # macro to include a target only if it's on the list of targets that make
  70 # was invoked with
  71 #
  72 # This allows you to have something like an "order-only phony prerequisite",
  73 # ie a prerequisite that determines an order phony targets have to run in.
  74 #
  75 # Because normal order-only prerequisites don't work with phony targets.
  76 #
  77 # example $(call prereq_if_explicit,erase_flash)
  78 define prereq_if_explicit
  79 $(filter $(1),$(MAKECMDGOALS))
  80 endef
  81
  82 # macro to kill duplicate items in a list without messing up the sort order of the list.
  83 # Will only keep the unique items; if there are non-unique items in the list, it will remove
  84 # the later recurring ones so only the first one remains.
  85 # Copied from http://stackoverflow.com/questions/16144115/makefile-remove-duplicate-words-without-sorting
  86 define uniq
  87 $(if $1,$(firstword $1) $(call uniq,$(filter-out $(firstword $1),$1)))
  88 endef
  89
  90 # macro to strip leading ../s from a path
  91 # Given $(1) which is a directory, remove any leading ../s from it
  92 # (recursively keeps removing ../ until not found)
  93 # if the path contains nothing but ../.., a single . is returned (cwd)
  94 define stripLeadingParentDirs
  95 $(foreach path,$(1),$(if $(subst ..,,$(path)),$(if $(filter ../%,$(path)),$(call stripLeadingParentDirs,$(patsubst ../%,%,$(path))),$(path)),.))
  96 endef