esp-idf/make/project_config.mk

# Makefile support for the menuconfig system

#Find all Kconfig files for all components
COMPONENT_KCONFIGS := $(foreach component,$(COMPONENT_PATHS),$(wildcard $(component)/Kconfig))
COMPONENT_KCONFIGS_PROJBUILD := $(foreach component,$(COMPONENT_PATHS),$(wildcard $(component)/Kconfig.projbuild))

#For doing make menuconfig etc
KCONFIG_TOOL_DIR=$(IDF_PATH)/tools/kconfig

# set SDKCONFIG to the project's sdkconfig,
# unless it's overriden (happens for bootloader)
SDKCONFIG ?= $(PROJECT_PATH)/sdkconfig

# SDKCONFIG_DEFAULTS is an optional file containing default
# overrides (usually used for esp-idf examples)
SDKCONFIG_DEFAULTS ?= $(PROJECT_PATH)/sdkconfig.defaults

# reset MAKEFLAGS as the menuconfig makefile uses implicit compile rules
$(KCONFIG_TOOL_DIR)/mconf $(KCONFIG_TOOL_DIR)/conf:
	MAKEFLAGS=$(ORIGINAL_MAKEFLAGS) CC=$(HOSTCC) LD=$(HOSTLD) \
	$(MAKE) -C $(KCONFIG_TOOL_DIR)

# use a wrapper environment for where we run Kconfig tools
KCONFIG_TOOL_ENV=KCONFIG_AUTOHEADER=$(abspath $(BUILD_DIR_BASE)/include/sdkconfig.h) \
	COMPONENT_KCONFIGS="$(COMPONENT_KCONFIGS)" KCONFIG_CONFIG=$(SDKCONFIG) \
	COMPONENT_KCONFIGS_PROJBUILD="$(COMPONENT_KCONFIGS_PROJBUILD)"

menuconfig: $(KCONFIG_TOOL_DIR)/mconf $(IDF_PATH)/Kconfig $(call prereq_if_explicit,defconfig)
	$(summary) MENUCONFIG
	$(KCONFIG_TOOL_ENV) $(KCONFIG_TOOL_DIR)/mconf $(IDF_PATH)/Kconfig

ifeq ("$(wildcard $(SDKCONFIG))","")
ifeq ("$(call prereq_if_explicit,defconfig)","")
# if not configuration is present and defconfig is not a target, run defconfig then menuconfig
$(SDKCONFIG): defconfig menuconfig
else
# otherwise, just defconfig
$(SDKCONFIG): defconfig
endif
endif

# defconfig creates a default config, based on SDKCONFIG_DEFAULTS if present
defconfig: $(KCONFIG_TOOL_DIR)/mconf $(IDF_PATH)/Kconfig $(BUILD_DIR_BASE)
	$(summary) DEFCONFIG
ifneq ("$(wildcard $(SDKCONFIG_DEFAULTS))","")
	cat $(SDKCONFIG_DEFAULTS) >> $(SDKCONFIG)  # append defaults to sdkconfig, will override existing values
endif
	mkdir -p $(BUILD_DIR_BASE)/include/config
	$(KCONFIG_TOOL_ENV) $(KCONFIG_TOOL_DIR)/conf --olddefconfig $(IDF_PATH)/Kconfig

# Work out of whether we have to build the Kconfig makefile
# (auto.conf), or if we're in a situation where we don't need it
NON_CONFIG_TARGETS := clean %-clean help menuconfig defconfig
AUTO_CONF_REGEN_TARGET := $(SDKCONFIG_MAKEFILE)

# disable AUTO_CONF_REGEN_TARGET if all targets are non-config targets
# (and not building default target)
ifneq ("$(MAKECMDGOALS)","")
ifeq ($(filter $(NON_CONFIG_TARGETS), $(MAKECMDGOALS)),$(MAKECMDGOALS))
AUTO_CONF_REGEN_TARGET :=
# dummy target
$(SDKCONFIG_MAKEFILE):
endif
endif

$(AUTO_CONF_REGEN_TARGET) $(BUILD_DIR_BASE)/include/sdkconfig.h: $(SDKCONFIG) $(KCONFIG_TOOL_DIR)/conf $(COMPONENT_KCONFIGS) $(COMPONENT_KCONFIGS_PROJBUILD)
	$(summary) GENCONFIG
	mkdir -p $(BUILD_DIR_BASE)/include/config
	cd $(BUILD_DIR_BASE); $(KCONFIG_TOOL_ENV) $(KCONFIG_TOOL_DIR)/conf --silentoldconfig $(IDF_PATH)/Kconfig
	touch $(AUTO_CONF_REGEN_TARGET) $(BUILD_DIR_BASE)/include/sdkconfig.h
# touch to ensure both output files are newer - as 'conf' can also update sdkconfig (a dependency). Without this,
# sometimes you can get an infinite make loop on Windows where sdkconfig always gets regenerated newer
# than the target(!)

.PHONY: config-clean
config-clean:
	$(summary RM CONFIG)
	$(MAKE) -C $(KCONFIG_TOOL_DIR) clean
	rm -rf $(BUILD_DIR_BASE)/include/config $(BUILD_DIR_BASE)/include/sdkconfig.h
Initial public version 2016-08-17 11:08:22 -04:00			`# Makefile support for the menuconfig system`

			`#Find all Kconfig files for all components`
			`COMPONENT_KCONFIGS := $(foreach component,$(COMPONENT_PATHS),$(wildcard $(component)/Kconfig))`
			`COMPONENT_KCONFIGS_PROJBUILD := $(foreach component,$(COMPONENT_PATHS),$(wildcard $(component)/Kconfig.projbuild))`

			`#For doing make menuconfig etc`
Use IDF_PATH instead of SDK_PATH for the environment variable pointing to esp-idf This will require a matching change in all projects using ESP-IDF. 2016-08-19 02:32:35 -04:00			`KCONFIG_TOOL_DIR=$(IDF_PATH)/tools/kconfig`
Initial public version 2016-08-17 11:08:22 -04:00
config system: Fix configuration when BUILD_DIR_BASE out-of-tree Ref #38. Also no longer generates bootloader sdkconfig in source tree. 2016-10-04 00:38:20 -04:00			`# set SDKCONFIG to the project's sdkconfig,`
			`# unless it's overriden (happens for bootloader)`
			`SDKCONFIG ?= $(PROJECT_PATH)/sdkconfig`

examples: Move sdkconfig.defaults support into build system Is used fairly widely, and a little bit buggy in the form where it was in each Makefile (didn't always get copied in place). 2016-12-20 20:46:24 -05:00			`# SDKCONFIG_DEFAULTS is an optional file containing default`
			`# overrides (usually used for esp-idf examples)`
			`SDKCONFIG_DEFAULTS ?= $(PROJECT_PATH)/sdkconfig.defaults`

build system: Run parallel builds without warnings Ref github #38 2016-10-06 03:29:34 -04:00			`# reset MAKEFLAGS as the menuconfig makefile uses implicit compile rules`
Initial public version 2016-08-17 11:08:22 -04:00			`$(KCONFIG_TOOL_DIR)/mconf $(KCONFIG_TOOL_DIR)/conf:`
build system: Run parallel builds without warnings Ref github #38 2016-10-06 03:29:34 -04:00			`MAKEFLAGS=$(ORIGINAL_MAKEFLAGS) CC=$(HOSTCC) LD=$(HOSTLD) \`
Initial public version 2016-08-17 11:08:22 -04:00			`$(MAKE) -C $(KCONFIG_TOOL_DIR)`

build system: Fix out-of-tree building via BUILD_DIR_BASE Closes #38 2016-10-04 00:03:48 -04:00			`# use a wrapper environment for where we run Kconfig tools`
build system: Allow BUILD_DIR_BASE to be a relative directory (see github #38) 2016-10-06 03:05:51 -04:00			`KCONFIG_TOOL_ENV=KCONFIG_AUTOHEADER=$(abspath $(BUILD_DIR_BASE)/include/sdkconfig.h) \`
config system: Fix configuration when BUILD_DIR_BASE out-of-tree Ref #38. Also no longer generates bootloader sdkconfig in source tree. 2016-10-04 00:38:20 -04:00			`COMPONENT_KCONFIGS="$(COMPONENT_KCONFIGS)" KCONFIG_CONFIG=$(SDKCONFIG) \`
build system: Fix out-of-tree building via BUILD_DIR_BASE Closes #38 2016-10-04 00:03:48 -04:00			`COMPONENT_KCONFIGS_PROJBUILD="$(COMPONENT_KCONFIGS_PROJBUILD)"`

build system: Fix sdkconfig.defaults file preventing menuconfig changes 'make defconfig' now behaves similarly whether sdkconfig.defaults is present or not, and 'make menuconfig' doesn't trigger a defconfig. 2017-01-08 18:09:05 -05:00			`menuconfig: $(KCONFIG_TOOL_DIR)/mconf $(IDF_PATH)/Kconfig $(call prereq_if_explicit,defconfig)`
build system: Fix out-of-tree building via BUILD_DIR_BASE Closes #38 2016-10-04 00:03:48 -04:00			`$(summary) MENUCONFIG`
build system: Remove need for $(Q) macro in recipes, use --silent in MAKEFLAGS instead 2016-11-10 20:29:38 -05:00			`$(KCONFIG_TOOL_ENV) $(KCONFIG_TOOL_DIR)/mconf $(IDF_PATH)/Kconfig`
Initial public version 2016-08-17 11:08:22 -04:00
config system: Fix configuration when BUILD_DIR_BASE out-of-tree Ref #38. Also no longer generates bootloader sdkconfig in source tree. 2016-10-04 00:38:20 -04:00			`ifeq ("$(wildcard $(SDKCONFIG))","")`
build system: Fix bug where erase_flash was always invoked for flash Order-only prerequisites do not work for phony targets! 2016-12-22 00:32:19 -05:00			`ifeq ("$(call prereq_if_explicit,defconfig)","")`
examples: Move sdkconfig.defaults support into build system Is used fairly widely, and a little bit buggy in the form where it was in each Makefile (didn't always get copied in place). 2016-12-20 20:46:24 -05:00			`# if not configuration is present and defconfig is not a target, run defconfig then menuconfig`
			`$(SDKCONFIG): defconfig menuconfig`
build system: Fix defconfig vs menuconfig regression in 155f9124 2016-11-09 04:38:16 -05:00			`else`
examples: Move sdkconfig.defaults support into build system Is used fairly widely, and a little bit buggy in the form where it was in each Makefile (didn't always get copied in place). 2016-12-20 20:46:24 -05:00			`# otherwise, just defconfig`
build system: Fix defconfig vs menuconfig regression in 155f9124 2016-11-09 04:38:16 -05:00			`$(SDKCONFIG): defconfig`
			`endif`
Initial public version 2016-08-17 11:08:22 -04:00			`endif`

examples: Move sdkconfig.defaults support into build system Is used fairly widely, and a little bit buggy in the form where it was in each Makefile (didn't always get copied in place). 2016-12-20 20:46:24 -05:00			`# defconfig creates a default config, based on SDKCONFIG_DEFAULTS if present`
make: add defconfig, don't run silentoldconfig before menuconfig This commit fixes the case when new Kconfig configuration options were added and you run `make menuconfig`. Previously this would first show console prompt to set values for new options, and then launch menuconfig. Now this will just launch menuconfig. New target is added, defconfig, which may be useful for non-interactive environments to set default values for all new configuration options. 2016-08-23 04:18:36 -04:00			`defconfig: $(KCONFIG_TOOL_DIR)/mconf $(IDF_PATH)/Kconfig $(BUILD_DIR_BASE)`
Makefile: Rename $(vecho) to $(summary), add new $(details) for echoing details when V=1 2016-08-24 01:02:24 -04:00			`$(summary) DEFCONFIG`
examples: Move sdkconfig.defaults support into build system Is used fairly widely, and a little bit buggy in the form where it was in each Makefile (didn't always get copied in place). 2016-12-20 20:46:24 -05:00			`ifneq ("$(wildcard $(SDKCONFIG_DEFAULTS))","")`
build system: Fix sdkconfig.defaults file preventing menuconfig changes 'make defconfig' now behaves similarly whether sdkconfig.defaults is present or not, and 'make menuconfig' doesn't trigger a defconfig. 2017-01-08 18:09:05 -05:00			`cat $(SDKCONFIG_DEFAULTS) >> $(SDKCONFIG) # append defaults to sdkconfig, will override existing values`
examples: Move sdkconfig.defaults support into build system Is used fairly widely, and a little bit buggy in the form where it was in each Makefile (didn't always get copied in place). 2016-12-20 20:46:24 -05:00			`endif`
build system: Remove need for $(Q) macro in recipes, use --silent in MAKEFLAGS instead 2016-11-10 20:29:38 -05:00			`mkdir -p $(BUILD_DIR_BASE)/include/config`
			`$(KCONFIG_TOOL_ENV) $(KCONFIG_TOOL_DIR)/conf --olddefconfig $(IDF_PATH)/Kconfig`
Initial public version 2016-08-17 11:08:22 -04:00
			`# Work out of whether we have to build the Kconfig makefile`
			`# (auto.conf), or if we're in a situation where we don't need it`
build system: Replace get_variable target w/ component_project_vars.mk generated makefiles Reduces number of make invocations, allows variables exported in project to be seen in all component make processes, not just the main ones. Also makes a no-op build about 3x faster than it was. 2016-11-08 20:51:55 -05:00			`NON_CONFIG_TARGETS := clean %-clean help menuconfig defconfig`
build system: Refactor component.mk to not need component_common.mk New makefile component_wrapper.mk allows some variables to be set before component.mk is evaluated. This properly fixes problems with sdkconfig being hard to access in all phases of the build. Including component_common.mk is no longer necessary and will print a deprecation warning for components which use it. 2016-11-09 21:20:55 -05:00			`AUTO_CONF_REGEN_TARGET := $(SDKCONFIG_MAKEFILE)`
Initial public version 2016-08-17 11:08:22 -04:00
			`# disable AUTO_CONF_REGEN_TARGET if all targets are non-config targets`
			`# (and not building default target)`
			`ifneq ("$(MAKECMDGOALS)","")`
			`ifeq ($(filter $(NON_CONFIG_TARGETS), $(MAKECMDGOALS)),$(MAKECMDGOALS))`
			`AUTO_CONF_REGEN_TARGET :=`
			`# dummy target`
build system: Refactor component.mk to not need component_common.mk New makefile component_wrapper.mk allows some variables to be set before component.mk is evaluated. This properly fixes problems with sdkconfig being hard to access in all phases of the build. Including component_common.mk is no longer necessary and will print a deprecation warning for components which use it. 2016-11-09 21:20:55 -05:00			`$(SDKCONFIG_MAKEFILE):`
Initial public version 2016-08-17 11:08:22 -04:00			`endif`
			`endif`

config system: Fix configuration when BUILD_DIR_BASE out-of-tree Ref #38. Also no longer generates bootloader sdkconfig in source tree. 2016-10-04 00:38:20 -04:00			`$(AUTO_CONF_REGEN_TARGET) $(BUILD_DIR_BASE)/include/sdkconfig.h: $(SDKCONFIG) $(KCONFIG_TOOL_DIR)/conf $(COMPONENT_KCONFIGS) $(COMPONENT_KCONFIGS_PROJBUILD)`
Makefile: Rename $(vecho) to $(summary), add new $(details) for echoing details when V=1 2016-08-24 01:02:24 -04:00			`$(summary) GENCONFIG`
build system: Remove need for $(Q) macro in recipes, use --silent in MAKEFLAGS instead 2016-11-10 20:29:38 -05:00			`mkdir -p $(BUILD_DIR_BASE)/include/config`
			`cd $(BUILD_DIR_BASE); $(KCONFIG_TOOL_ENV) $(KCONFIG_TOOL_DIR)/conf --silentoldconfig $(IDF_PATH)/Kconfig`
			`touch $(AUTO_CONF_REGEN_TARGET) $(BUILD_DIR_BASE)/include/sdkconfig.h`
Initial public version 2016-08-17 11:08:22 -04:00			`# touch to ensure both output files are newer - as 'conf' can also update sdkconfig (a dependency). Without this,`
			`# sometimes you can get an infinite make loop on Windows where sdkconfig always gets regenerated newer`
			`# than the target(!)`

			`.PHONY: config-clean`
			`config-clean:`
Makefile: Rename $(vecho) to $(summary), add new $(details) for echoing details when V=1 2016-08-24 01:02:24 -04:00			`$(summary RM CONFIG)`
Initial public version 2016-08-17 11:08:22 -04:00			`$(MAKE) -C $(KCONFIG_TOOL_DIR) clean`
build system: Remove need for $(Q) macro in recipes, use --silent in MAKEFLAGS instead 2016-11-10 20:29:38 -05:00			`rm -rf $(BUILD_DIR_BASE)/include/config $(BUILD_DIR_BASE)/include/sdkconfig.h`