project.mk 21 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549
  1. #
  2. # Main Project Makefile
  3. # This Makefile is included directly from the user project Makefile in order to call the component.mk
  4. # makefiles of all components (in a separate make process) to build all the libraries, then links them
  5. # together into the final file. If so, PWD is the project dir (we assume).
  6. #
  7. #
  8. # This makefile requires the environment variable IDF_PATH to be set to the top-level esp-idf directory
  9. # where this file is located.
  10. #
  11. .PHONY: build-components menuconfig defconfig all build clean all_binaries check-submodules size size-components size-files list-components
  12. MAKECMDGOALS ?= all
  13. all: all_binaries
  14. # see below for recipe of 'all' target
  15. #
  16. # # other components will add dependencies to 'all_binaries'. The
  17. # reason all_binaries is used instead of 'all' is so that the flash
  18. # target can build everything without triggering the per-component "to
  19. # flash..." output targets.)
  20. help:
  21. @echo "Welcome to Espressif IDF build system. Some useful make targets:"
  22. @echo ""
  23. @echo "make menuconfig - Configure IDF project"
  24. @echo "make defconfig - Set defaults for all new configuration options"
  25. @echo ""
  26. @echo "make all - Build app, bootloader, partition table"
  27. @echo "make flash - Flash app, bootloader, partition table to a chip"
  28. @echo "make clean - Remove all build output"
  29. @echo "make size - Display the static memory footprint of the app"
  30. @echo "make size-components, size-files - Finer-grained memory footprints"
  31. @echo "make erase_flash - Erase entire flash contents"
  32. @echo "make monitor - Run idf_monitor tool to monitor serial output from app"
  33. @echo "make simple_monitor - Monitor serial output on terminal console"
  34. @echo "make list-components - List all components in the project"
  35. @echo ""
  36. @echo "make app - Build just the app"
  37. @echo "make app-flash - Flash just the app"
  38. @echo "make app-clean - Clean just the app"
  39. @echo "make print_flash_cmd - Print the arguments for esptool when flash"
  40. @echo ""
  41. @echo "See also 'make bootloader', 'make bootloader-flash', 'make bootloader-clean', "
  42. @echo "'make partition_table', etc, etc."
  43. # dependency checks
  44. ifndef MAKE_RESTARTS
  45. ifeq ("$(filter 4.% 3.81 3.82,$(MAKE_VERSION))","")
  46. $(warning esp-idf build system only supports GNU Make versions 3.81 or newer. You may see unexpected results with other Makes.)
  47. endif
  48. ifdef MSYSTEM
  49. ifneq ("$(MSYSTEM)","MINGW32")
  50. $(warning esp-idf build system only supports MSYS2 in "MINGW32" mode. Consult the ESP-IDF documentation for details.)
  51. endif
  52. endif # MSYSTEM
  53. endif # MAKE_RESTARTS
  54. # can't run 'clean' along with any non-clean targets
  55. ifneq ("$(filter clean% %clean,$(MAKECMDGOALS))" ,"")
  56. ifneq ("$(filter-out clean% %clean,$(MAKECMDGOALS))", "")
  57. $(error esp-idf build system doesn't support running 'clean' targets along with any others. Run 'make clean' and then run other targets separately.)
  58. endif
  59. endif
  60. OS ?=
  61. # make IDF_PATH a "real" absolute path
  62. # * works around the case where a shell character is embedded in the environment variable value.
  63. # * changes Windows-style C:/blah/ paths to MSYS style /c/blah
  64. ifeq ("$(OS)","Windows_NT")
  65. # On Windows MSYS2, make wildcard function returns empty string for paths of form /xyz
  66. # where /xyz is a directory inside the MSYS root - so we don't use it.
  67. SANITISED_IDF_PATH:=$(realpath $(IDF_PATH))
  68. else
  69. SANITISED_IDF_PATH:=$(realpath $(wildcard $(IDF_PATH)))
  70. endif
  71. export IDF_PATH := $(SANITISED_IDF_PATH)
  72. ifndef IDF_PATH
  73. $(error IDF_PATH variable is not set to a valid directory.)
  74. endif
  75. ifneq ("$(IDF_PATH)","$(SANITISED_IDF_PATH)")
  76. # implies IDF_PATH was overriden on make command line.
  77. # Due to the way make manages variables, this is hard to account for
  78. #
  79. # if you see this error, do the shell expansion in the shell ie
  80. # make IDF_PATH=~/blah not make IDF_PATH="~/blah"
  81. $(error If IDF_PATH is overriden on command line, it must be an absolute path with no embedded shell special characters)
  82. endif
  83. ifneq ("$(IDF_PATH)","$(subst :,,$(IDF_PATH))")
  84. $(error IDF_PATH cannot contain colons. If overriding IDF_PATH on Windows, use MSYS Unix-style /c/dir instead of C:/dir)
  85. endif
  86. # disable built-in make rules, makes debugging saner
  87. MAKEFLAGS_OLD := $(MAKEFLAGS)
  88. MAKEFLAGS +=-rR
  89. # Default path to the project: we assume the Makefile including this file
  90. # is in the project directory
  91. ifndef PROJECT_PATH
  92. PROJECT_PATH := $(abspath $(dir $(firstword $(MAKEFILE_LIST))))
  93. export PROJECT_PATH
  94. endif
  95. # A list of the "common" makefiles, to use as a target dependency
  96. COMMON_MAKEFILES := $(abspath $(IDF_PATH)/make/project.mk $(IDF_PATH)/make/common.mk $(IDF_PATH)/make/component_wrapper.mk $(firstword $(MAKEFILE_LIST)))
  97. export COMMON_MAKEFILES
  98. # The directory where we put all objects/libraries/binaries. The project Makefile can
  99. # configure this if needed.
  100. ifndef BUILD_DIR_BASE
  101. BUILD_DIR_BASE := $(PROJECT_PATH)/build
  102. endif
  103. export BUILD_DIR_BASE
  104. # Component directories. These directories are searched for components (either the directory is a component,
  105. # or the directory contains subdirectories which are components.)
  106. # The project Makefile can override these component dirs, or add extras via EXTRA_COMPONENT_DIRS
  107. ifndef COMPONENT_DIRS
  108. EXTRA_COMPONENT_DIRS ?=
  109. COMPONENT_DIRS := $(PROJECT_PATH)/components $(EXTRA_COMPONENT_DIRS) $(IDF_PATH)/components $(PROJECT_PATH)/main
  110. endif
  111. export COMPONENT_DIRS
  112. ifdef SRCDIRS
  113. $(warning SRCDIRS variable is deprecated. These paths can be added to EXTRA_COMPONENT_DIRS or COMPONENT_DIRS instead.)
  114. COMPONENT_DIRS += $(abspath $(SRCDIRS))
  115. endif
  116. # The project Makefile can define a list of components, but if it does not do this we just take all available components
  117. # in the component dirs. A component is COMPONENT_DIRS directory, or immediate subdirectory,
  118. # which contains a component.mk file.
  119. #
  120. # Use the "make list-components" target to debug this step.
  121. ifndef COMPONENTS
  122. # Find all component names. The component names are the same as the
  123. # directories they're in, so /bla/components/mycomponent/component.mk -> mycomponent.
  124. COMPONENTS := $(dir $(foreach cd,$(COMPONENT_DIRS), \
  125. $(wildcard $(cd)/*/component.mk) $(wildcard $(cd)/component.mk) \
  126. ))
  127. COMPONENTS := $(sort $(foreach comp,$(COMPONENTS),$(lastword $(subst /, ,$(comp)))))
  128. endif
  129. export COMPONENTS
  130. # Resolve all of COMPONENTS into absolute paths in COMPONENT_PATHS.
  131. #
  132. # If a component name exists in multiple COMPONENT_DIRS, we take the first match.
  133. #
  134. # NOTE: These paths must be generated WITHOUT a trailing / so we
  135. # can use $(notdir x) to get the component name.
  136. COMPONENT_PATHS := $(foreach comp,$(COMPONENTS),$(firstword $(foreach cd,$(COMPONENT_DIRS),$(wildcard $(dir $(cd))$(comp) $(cd)/$(comp)))))
  137. export COMPONENT_PATHS
  138. TEST_COMPONENTS ?=
  139. TESTS_ALL ?=
  140. # If TESTS_ALL set to 1, set TEST_COMPONENTS_LIST to all components.
  141. # Otherwise, use the list supplied in TEST_COMPONENTS.
  142. ifeq ($(TESTS_ALL),1)
  143. TEST_COMPONENTS_LIST := $(COMPONENTS)
  144. else
  145. TEST_COMPONENTS_LIST := $(TEST_COMPONENTS)
  146. endif
  147. TEST_COMPONENT_PATHS := $(foreach comp,$(TEST_COMPONENTS_LIST),$(firstword $(foreach dir,$(COMPONENT_DIRS),$(wildcard $(dir)/$(comp)/test))))
  148. TEST_COMPONENT_NAMES := $(foreach comp,$(TEST_COMPONENT_PATHS),$(lastword $(subst /, ,$(dir $(comp))))_test)
  149. # Initialise project-wide variables which can be added to by
  150. # each component.
  151. #
  152. # These variables are built up via the component_project_vars.mk
  153. # generated makefiles (one per component).
  154. #
  155. # See docs/build-system.rst for more details.
  156. COMPONENT_INCLUDES :=
  157. COMPONENT_LDFLAGS :=
  158. COMPONENT_SUBMODULES :=
  159. COMPONENT_LIBRARIES :=
  160. # COMPONENT_PROJECT_VARS is the list of component_project_vars.mk generated makefiles
  161. # for each component.
  162. #
  163. # Including $(COMPONENT_PROJECT_VARS) builds the COMPONENT_INCLUDES,
  164. # COMPONENT_LDFLAGS variables and also targets for any inter-component
  165. # dependencies.
  166. #
  167. # See the component_project_vars.mk target in component_wrapper.mk
  168. COMPONENT_PROJECT_VARS := $(addsuffix /component_project_vars.mk,$(notdir $(COMPONENT_PATHS) ) $(TEST_COMPONENT_NAMES))
  169. COMPONENT_PROJECT_VARS := $(addprefix $(BUILD_DIR_BASE)/,$(COMPONENT_PROJECT_VARS))
  170. # this line is -include instead of include to prevent a spurious error message on make 3.81
  171. -include $(COMPONENT_PROJECT_VARS)
  172. # Also add top-level project include path, for top-level includes
  173. COMPONENT_INCLUDES += $(abspath $(BUILD_DIR_BASE)/include/)
  174. export COMPONENT_INCLUDES
  175. # Set variables common to both project & component
  176. include $(IDF_PATH)/make/common.mk
  177. all:
  178. ifdef CONFIG_SECURE_BOOT_ENABLED
  179. @echo "(Secure boot enabled, so bootloader not flashed automatically. See 'make bootloader' output)"
  180. ifndef CONFIG_SECURE_BOOT_BUILD_SIGNED_BINARIES
  181. @echo "App built but not signed. Sign app & partition data before flashing, via espsecure.py:"
  182. @echo "espsecure.py sign_data --keyfile KEYFILE $(APP_BIN)"
  183. @echo "espsecure.py sign_data --keyfile KEYFILE $(PARTITION_TABLE_BIN)"
  184. endif
  185. @echo "To flash app & partition table, run 'make flash' or:"
  186. else
  187. @echo "To flash all build output, run 'make flash' or:"
  188. endif
  189. @echo $(ESPTOOLPY_WRITE_FLASH) $(ESPTOOL_ALL_FLASH_ARGS)
  190. IDF_VER := $(shell cd ${IDF_PATH} && git describe --always --tags --dirty)
  191. # Set default LDFLAGS
  192. EXTRA_LDFLAGS ?=
  193. LDFLAGS ?= -nostdlib \
  194. -u call_user_start_cpu0 \
  195. $(EXTRA_LDFLAGS) \
  196. -Wl,--gc-sections \
  197. -Wl,-static \
  198. -Wl,--start-group \
  199. $(COMPONENT_LDFLAGS) \
  200. -lgcc \
  201. -lstdc++ \
  202. -lgcov \
  203. -Wl,--end-group \
  204. -Wl,-EL
  205. # Set default CPPFLAGS, CFLAGS, CXXFLAGS
  206. # These are exported so that components can use them when compiling.
  207. # If you need your component to add CFLAGS/etc for it's own source compilation only, set CFLAGS += in your component's Makefile.
  208. # If you need your component to add CFLAGS/etc globally for all source
  209. # files, set CFLAGS += in your component's Makefile.projbuild
  210. # If you need to set CFLAGS/CPPFLAGS/CXXFLAGS at project level, set them in application Makefile
  211. # before including project.mk. Default flags will be added before the ones provided in application Makefile.
  212. # CPPFLAGS used by C preprocessor
  213. # If any flags are defined in application Makefile, add them at the end.
  214. CPPFLAGS ?=
  215. EXTRA_CPPFLAGS ?=
  216. CPPFLAGS := -DESP_PLATFORM -D IDF_VER=\"$(IDF_VER)\" -MMD -MP $(CPPFLAGS) $(EXTRA_CPPFLAGS)
  217. # Warnings-related flags relevant both for C and C++
  218. COMMON_WARNING_FLAGS = -Wall -Werror=all \
  219. -Wno-error=unused-function \
  220. -Wno-error=unused-but-set-variable \
  221. -Wno-error=unused-variable \
  222. -Wno-error=deprecated-declarations \
  223. -Wextra \
  224. -Wno-unused-parameter -Wno-sign-compare
  225. # Flags which control code generation and dependency generation, both for C and C++
  226. COMMON_FLAGS = \
  227. -ffunction-sections -fdata-sections \
  228. -fstrict-volatile-bitfields \
  229. -mlongcalls \
  230. -nostdlib
  231. ifndef IS_BOOTLOADER_BUILD
  232. # stack protection (only one option can be selected in menuconfig)
  233. ifdef CONFIG_STACK_CHECK_NORM
  234. COMMON_FLAGS += -fstack-protector
  235. endif
  236. ifdef CONFIG_STACK_CHECK_STRONG
  237. COMMON_FLAGS += -fstack-protector-strong
  238. endif
  239. ifdef CONFIG_STACK_CHECK_ALL
  240. COMMON_FLAGS += -fstack-protector-all
  241. endif
  242. endif
  243. # Optimization flags are set based on menuconfig choice
  244. ifdef CONFIG_OPTIMIZATION_LEVEL_RELEASE
  245. OPTIMIZATION_FLAGS = -Os
  246. else
  247. OPTIMIZATION_FLAGS = -Og
  248. endif
  249. ifdef CONFIG_OPTIMIZATION_ASSERTIONS_DISABLED
  250. CPPFLAGS += -DNDEBUG
  251. endif
  252. # Enable generation of debugging symbols
  253. # (we generate even in Release mode, as this has no impact on final binary size.)
  254. DEBUG_FLAGS ?= -ggdb
  255. # List of flags to pass to C compiler
  256. # If any flags are defined in application Makefile, add them at the end.
  257. CFLAGS ?=
  258. EXTRA_CFLAGS ?=
  259. CFLAGS := $(strip \
  260. -std=gnu99 \
  261. $(OPTIMIZATION_FLAGS) $(DEBUG_FLAGS) \
  262. $(COMMON_FLAGS) \
  263. $(COMMON_WARNING_FLAGS) -Wno-old-style-declaration \
  264. $(CFLAGS) \
  265. $(EXTRA_CFLAGS))
  266. # List of flags to pass to C++ compiler
  267. # If any flags are defined in application Makefile, add them at the end.
  268. CXXFLAGS ?=
  269. EXTRA_CXXFLAGS ?=
  270. CXXFLAGS := $(strip \
  271. -std=gnu++11 \
  272. -fno-rtti \
  273. $(OPTIMIZATION_FLAGS) $(DEBUG_FLAGS) \
  274. $(COMMON_FLAGS) \
  275. $(COMMON_WARNING_FLAGS) \
  276. $(CXXFLAGS) \
  277. $(EXTRA_CXXFLAGS))
  278. ifdef CONFIG_CXX_EXCEPTIONS
  279. CXXFLAGS += -fexceptions
  280. else
  281. CXXFLAGS += -fno-exceptions
  282. endif
  283. export CFLAGS CPPFLAGS CXXFLAGS
  284. # Set default values that were not previously defined
  285. CC ?= gcc
  286. LD ?= ld
  287. AR ?= ar
  288. OBJCOPY ?= objcopy
  289. SIZE ?= size
  290. # Set host compiler and binutils
  291. HOSTCC := $(CC)
  292. HOSTLD := $(LD)
  293. HOSTAR := $(AR)
  294. HOSTOBJCOPY := $(OBJCOPY)
  295. HOSTSIZE := $(SIZE)
  296. export HOSTCC HOSTLD HOSTAR HOSTOBJCOPY SIZE
  297. # Set target compiler. Defaults to whatever the user has
  298. # configured as prefix + ye olde gcc commands
  299. CC := $(call dequote,$(CONFIG_TOOLPREFIX))gcc
  300. CXX := $(call dequote,$(CONFIG_TOOLPREFIX))c++
  301. LD := $(call dequote,$(CONFIG_TOOLPREFIX))ld
  302. AR := $(call dequote,$(CONFIG_TOOLPREFIX))ar
  303. OBJCOPY := $(call dequote,$(CONFIG_TOOLPREFIX))objcopy
  304. SIZE := $(call dequote,$(CONFIG_TOOLPREFIX))size
  305. export CC CXX LD AR OBJCOPY SIZE
  306. PYTHON=$(call dequote,$(CONFIG_PYTHON))
  307. # the app is the main executable built by the project
  308. APP_ELF:=$(BUILD_DIR_BASE)/$(PROJECT_NAME).elf
  309. APP_MAP:=$(APP_ELF:.elf=.map)
  310. APP_BIN:=$(APP_ELF:.elf=.bin)
  311. # Include any Makefile.projbuild file letting components add
  312. # configuration at the project level
  313. define includeProjBuildMakefile
  314. $(if $(V),$(info including $(1)/Makefile.projbuild...))
  315. COMPONENT_PATH := $(1)
  316. include $(1)/Makefile.projbuild
  317. endef
  318. $(foreach componentpath,$(COMPONENT_PATHS), \
  319. $(if $(wildcard $(componentpath)/Makefile.projbuild), \
  320. $(eval $(call includeProjBuildMakefile,$(componentpath)))))
  321. # once we know component paths, we can include the config generation targets
  322. #
  323. # (bootloader build doesn't need this, config is exported from top-level)
  324. ifndef IS_BOOTLOADER_BUILD
  325. include $(IDF_PATH)/make/project_config.mk
  326. endif
  327. # ELF depends on the library archive files for COMPONENT_LIBRARIES
  328. # the rules to build these are emitted as part of GenerateComponentTarget below
  329. #
  330. # also depends on additional dependencies (linker scripts & binary libraries)
  331. # stored in COMPONENT_LINKER_DEPS, built via component.mk files' COMPONENT_ADD_LINKER_DEPS variable
  332. COMPONENT_LINKER_DEPS ?=
  333. $(APP_ELF): $(foreach libcomp,$(COMPONENT_LIBRARIES),$(BUILD_DIR_BASE)/$(libcomp)/lib$(libcomp).a) $(COMPONENT_LINKER_DEPS) $(COMPONENT_PROJECT_VARS)
  334. $(summary) LD $(patsubst $(PWD)/%,%,$@)
  335. $(CC) $(LDFLAGS) -o $@ -Wl,-Map=$(APP_MAP)
  336. app: $(APP_BIN)
  337. ifeq ("$(CONFIG_SECURE_BOOT_ENABLED)$(CONFIG_SECURE_BOOT_BUILD_SIGNED_BINARIES)","y") # secure boot enabled, but remote sign app image
  338. @echo "App built but not signed. Signing step via espsecure.py:"
  339. @echo "espsecure.py sign_data --keyfile KEYFILE $(APP_BIN)"
  340. @echo "Then flash app command is:"
  341. @echo $(ESPTOOLPY_WRITE_FLASH) $(CONFIG_APP_OFFSET) $(APP_BIN)
  342. else
  343. @echo "App built. Default flash app command is:"
  344. @echo $(ESPTOOLPY_WRITE_FLASH) $(CONFIG_APP_OFFSET) $(APP_BIN)
  345. endif
  346. all_binaries: $(APP_BIN)
  347. $(BUILD_DIR_BASE):
  348. mkdir -p $(BUILD_DIR_BASE)
  349. # Macro for the recursive sub-make for each component
  350. # $(1) - component directory
  351. # $(2) - component name only
  352. #
  353. # Is recursively expanded by the GenerateComponentTargets macro
  354. define ComponentMake
  355. +$(MAKE) -C $(BUILD_DIR_BASE)/$(2) -f $(IDF_PATH)/make/component_wrapper.mk COMPONENT_MAKEFILE=$(1)/component.mk COMPONENT_NAME=$(2)
  356. endef
  357. # Generate top-level component-specific targets for each component
  358. # $(1) - path to component dir
  359. # $(2) - name of component
  360. #
  361. define GenerateComponentTargets
  362. .PHONY: component-$(2)-build component-$(2)-clean
  363. component-$(2)-build: check-submodules $(call prereq_if_explicit, component-$(2)-clean) | $(BUILD_DIR_BASE)/$(2)
  364. $(call ComponentMake,$(1),$(2)) build
  365. component-$(2)-clean: | $(BUILD_DIR_BASE)/$(2) $(BUILD_DIR_BASE)/$(2)/component_project_vars.mk
  366. $(call ComponentMake,$(1),$(2)) clean
  367. $(BUILD_DIR_BASE)/$(2):
  368. @mkdir -p $(BUILD_DIR_BASE)/$(2)
  369. # tell make it can build any component's library by invoking the -build target
  370. # (this target exists for all components even ones which don't build libraries, but it's
  371. # only invoked for the targets whose libraries appear in COMPONENT_LIBRARIES and hence the
  372. # APP_ELF dependencies.)
  373. $(BUILD_DIR_BASE)/$(2)/lib$(2).a: component-$(2)-build
  374. $(details) "Target '$$^' responsible for '$$@'" # echo which build target built this file
  375. # add a target to generate the component_project_vars.mk files that
  376. # are used to inject variables into project make pass (see matching
  377. # component_project_vars.mk target in component_wrapper.mk).
  378. #
  379. # If any component_project_vars.mk file is out of date, the make
  380. # process will call this target to rebuild it and then restart.
  381. #
  382. $(BUILD_DIR_BASE)/$(2)/component_project_vars.mk: $(1)/component.mk $(COMMON_MAKEFILES) $(SDKCONFIG_MAKEFILE) | $(BUILD_DIR_BASE)/$(2)
  383. $(call ComponentMake,$(1),$(2)) component_project_vars.mk
  384. endef
  385. $(foreach component,$(COMPONENT_PATHS),$(eval $(call GenerateComponentTargets,$(component),$(notdir $(component)))))
  386. $(foreach component,$(TEST_COMPONENT_PATHS),$(eval $(call GenerateComponentTargets,$(component),$(lastword $(subst /, ,$(dir $(component))))_test)))
  387. app-clean: $(addprefix component-,$(addsuffix -clean,$(notdir $(COMPONENT_PATHS))))
  388. $(summary) RM $(APP_ELF)
  389. rm -f $(APP_ELF) $(APP_BIN) $(APP_MAP)
  390. size: $(APP_ELF)
  391. $(PYTHON) $(IDF_PATH)/tools/idf_size.py $(APP_MAP)
  392. size-files: $(APP_ELF)
  393. $(PYTHON) $(IDF_PATH)/tools/idf_size.py --files $(APP_MAP)
  394. size-components: $(APP_ELF)
  395. $(PYTHON) $(IDF_PATH)/tools/idf_size.py --archives $(APP_MAP)
  396. # NB: this ordering is deliberate (app-clean & bootloader-clean before
  397. # _config-clean), so config remains valid during all component clean
  398. # targets
  399. config-clean: app-clean bootloader-clean
  400. clean: app-clean bootloader-clean config-clean
  401. # phony target to check if any git submodule listed in COMPONENT_SUBMODULES are missing
  402. # or out of date, and exit if so. Components can add paths to this variable.
  403. #
  404. # This only works for components inside IDF_PATH
  405. check-submodules:
  406. # Dump the git status for the whole working copy once, then grep it for each submodule. This saves a lot of time on Windows.
  407. GIT_STATUS := $(shell cd ${IDF_PATH} && git status --porcelain --ignore-submodules=dirty)
  408. # Generate a target to check this submodule
  409. # $(1) - submodule directory, relative to IDF_PATH
  410. define GenerateSubmoduleCheckTarget
  411. check-submodules: $(IDF_PATH)/$(1)/.git
  412. $(IDF_PATH)/$(1)/.git:
  413. @echo "WARNING: Missing submodule $(1)..."
  414. [ -e ${IDF_PATH}/.git ] || ( echo "ERROR: esp-idf must be cloned from git to work."; exit 1)
  415. [ -x $$(which git) ] || ( echo "ERROR: Need to run 'git submodule init $(1)' in esp-idf root directory."; exit 1)
  416. @echo "Attempting 'git submodule update --init $(1)' in esp-idf root directory..."
  417. cd ${IDF_PATH} && git submodule update --init $(1)
  418. # Parse 'git status' output to check if the submodule commit is different to expected
  419. ifneq ("$(filter $(1),$(GIT_STATUS))","")
  420. $$(info WARNING: esp-idf git submodule $(1) may be out of date. Run 'git submodule update' in IDF_PATH dir to update.)
  421. endif
  422. endef
  423. # filter/subst in expression ensures all submodule paths begin with $(IDF_PATH), and then strips that prefix
  424. # so the argument is suitable for use with 'git submodule' commands
  425. $(foreach submodule,$(subst $(IDF_PATH)/,,$(filter $(IDF_PATH)/%,$(COMPONENT_SUBMODULES))),$(eval $(call GenerateSubmoduleCheckTarget,$(submodule))))
  426. # PHONY target to list components in the build and their paths
  427. list-components:
  428. $(info $(call dequote,$(SEPARATOR)))
  429. $(info COMPONENT_DIRS (components searched for here))
  430. $(foreach cd,$(COMPONENT_DIRS),$(info $(cd)))
  431. $(info $(call dequote,$(SEPARATOR)))
  432. $(info COMPONENTS (list of component names))
  433. $(info $(COMPONENTS))
  434. $(info $(call dequote,$(SEPARATOR)))
  435. $(info COMPONENT_PATHS (paths to all components):)
  436. $(foreach cp,$(COMPONENT_PATHS),$(info $(cp)))
  437. # print flash command, so users can dump this to config files and download somewhere without idf
  438. print_flash_cmd:
  439. echo $(ESPTOOL_WRITE_FLASH_OPTIONS) $(ESPTOOL_ALL_FLASH_ARGS) | sed -e 's:'$(PWD)/build/'::g'
  440. # Check toolchain version using the output of xtensa-esp32-elf-gcc --version command.
  441. # The output normally looks as follows
  442. # xtensa-esp32-elf-gcc (crosstool-NG crosstool-ng-1.22.0-59-ga194053) 4.8.5
  443. # The part in brackets is extracted into TOOLCHAIN_COMMIT_DESC variable,
  444. # the part after the brackets is extracted into TOOLCHAIN_GCC_VER.
  445. ifdef CONFIG_TOOLPREFIX
  446. ifndef MAKE_RESTARTS
  447. TOOLCHAIN_COMMIT_DESC := $(shell $(CC) --version | sed -E -n 's|.*crosstool-ng-([0-9]+).([0-9]+).([0-9]+)-([0-9]+)-g([0-9a-f]{7}).*|\1.\2.\3-\4-g\5|gp')
  448. TOOLCHAIN_GCC_VER := $(shell $(CC) --version | sed -E -n 's|xtensa-esp32-elf-gcc.*\ \(.*\)\ (.*)|\1|gp')
  449. # Officially supported version(s)
  450. SUPPORTED_TOOLCHAIN_COMMIT_DESC := 1.22.0-80-g6c4433a
  451. SUPPORTED_TOOLCHAIN_GCC_VERSIONS := 5.2.0
  452. ifdef TOOLCHAIN_COMMIT_DESC
  453. ifneq ($(TOOLCHAIN_COMMIT_DESC), $(SUPPORTED_TOOLCHAIN_COMMIT_DESC))
  454. $(info WARNING: Toolchain version is not supported: $(TOOLCHAIN_COMMIT_DESC))
  455. $(info Expected to see version: $(SUPPORTED_TOOLCHAIN_COMMIT_DESC))
  456. $(info Please check ESP-IDF setup instructions and update the toolchain, or proceed at your own risk.)
  457. endif
  458. ifeq (,$(findstring $(TOOLCHAIN_GCC_VER), $(SUPPORTED_TOOLCHAIN_GCC_VERSIONS)))
  459. $(info WARNING: Compiler version is not supported: $(TOOLCHAIN_GCC_VER))
  460. $(info Expected to see version(s): $(SUPPORTED_TOOLCHAIN_GCC_VERSIONS))
  461. $(info Please check ESP-IDF setup instructions and update the toolchain, or proceed at your own risk.)
  462. endif
  463. else
  464. $(info WARNING: Failed to find Xtensa toolchain, may need to alter PATH or set one in the configuration menu)
  465. endif # TOOLCHAIN_COMMIT_DESC
  466. endif #MAKE_RESTARTS
  467. endif #CONFIG_TOOLPREFIX