mirror of
https://github.com/licsber/micropython.git
synced 2024-09-20 00:50:24 +08:00
ce2058685b
Make can't handle paths with spaces, see https://savannah.gnu.org/bugs/?712 The following workarounds exist: - When using make's built-in functions: - Use relative paths wherever possible to avoid spaces in the first place. - All spaces in paths can be escaped with backslashes; quotes don't work. - Some users use the shell to temporarily rename directories, or to create symlinks without spaces. - When using make to pass commands to the system's shell, enclose paths in quotes. While make will still interpret quoted strings with spaces as multiple words, the system's shell will correctly parse the resulting command. This commit contains the following fixes: - In ports/stm32/mboot/Makefile: Use relative paths to avoid spaces when using built-in functions. - In all other files: Use quotes to enclose paths when make is used to call shell functions. All changes have been tested with a directory containing spaces. Signed-off-by: Iksas <iksas@mailbox.org>
287 lines
10 KiB
Makefile
287 lines
10 KiB
Makefile
ifneq ($(MKENV_INCLUDED),1)
|
|
# We assume that mkenv is in the same directory as this file.
|
|
THIS_MAKEFILE = $(lastword $(MAKEFILE_LIST))
|
|
include $(dir $(THIS_MAKEFILE))mkenv.mk
|
|
endif
|
|
|
|
# Enable in-progress/breaking changes that are slated for MicroPython 2.x.
|
|
MICROPY_PREVIEW_VERSION_2 ?= 0
|
|
|
|
ifeq ($(MICROPY_PREVIEW_VERSION_2),1)
|
|
CFLAGS += -DMICROPY_PREVIEW_VERSION_2=1
|
|
endif
|
|
|
|
HELP_BUILD_ERROR ?= "See \033[1;31mhttps://github.com/micropython/micropython/wiki/Build-Troubleshooting\033[0m"
|
|
HELP_MPY_LIB_SUBMODULE ?= "\033[1;31mError: micropython-lib submodule is not initialized.\033[0m Run 'make submodules'"
|
|
|
|
# Extra deps that need to happen before object compilation.
|
|
OBJ_EXTRA_ORDER_DEPS =
|
|
|
|
# Generate header files.
|
|
OBJ_EXTRA_ORDER_DEPS += $(HEADER_BUILD)/moduledefs.h $(HEADER_BUILD)/root_pointers.h
|
|
|
|
ifeq ($(MICROPY_ROM_TEXT_COMPRESSION),1)
|
|
# If compression is enabled, trigger the build of compressed.data.h...
|
|
OBJ_EXTRA_ORDER_DEPS += $(HEADER_BUILD)/compressed.data.h
|
|
# ...and enable the MP_COMPRESSED_ROM_TEXT macro (used by MP_ERROR_TEXT).
|
|
CFLAGS += -DMICROPY_ROM_TEXT_COMPRESSION=1
|
|
endif
|
|
|
|
# QSTR generation uses the same CFLAGS, with these modifications.
|
|
QSTR_GEN_FLAGS = -DNO_QSTR
|
|
# Note: := to force evaluation immediately.
|
|
QSTR_GEN_CFLAGS := $(CFLAGS)
|
|
QSTR_GEN_CFLAGS += $(QSTR_GEN_FLAGS)
|
|
QSTR_GEN_CXXFLAGS := $(CXXFLAGS)
|
|
QSTR_GEN_CXXFLAGS += $(QSTR_GEN_FLAGS)
|
|
|
|
# This file expects that OBJ contains a list of all of the object files.
|
|
# The directory portion of each object file is used to locate the source
|
|
# and should not contain any ..'s but rather be relative to the top of the
|
|
# tree.
|
|
#
|
|
# So for example, py/map.c would have an object file name py/map.o
|
|
# The object files will go into the build directory and maintain the same
|
|
# directory structure as the source tree. So the final dependency will look
|
|
# like this:
|
|
#
|
|
# build/py/map.o: py/map.c
|
|
#
|
|
# We set vpath to point to the top of the tree so that the source files
|
|
# can be located. By following this scheme, it allows a single build rule
|
|
# to be used to compile all .c files.
|
|
|
|
vpath %.S . $(TOP) $(USER_C_MODULES)
|
|
$(BUILD)/%.o: %.S
|
|
$(ECHO) "CC $<"
|
|
$(Q)$(CC) $(CFLAGS) -c -o $@ $<
|
|
|
|
vpath %.s . $(TOP) $(USER_C_MODULES)
|
|
$(BUILD)/%.o: %.s
|
|
$(ECHO) "AS $<"
|
|
$(Q)$(AS) $(AFLAGS) -o $@ $<
|
|
|
|
define compile_c
|
|
$(ECHO) "CC $<"
|
|
$(Q)$(CC) $(CFLAGS) -c -MD -MF $(@:.o=.d) -o $@ $< || (echo -e $(HELP_BUILD_ERROR); false)
|
|
@# The following fixes the dependency file.
|
|
@# See http://make.paulandlesley.org/autodep.html for details.
|
|
@# Regex adjusted from the above to play better with Windows paths, etc.
|
|
@$(CP) $(@:.o=.d) $(@:.o=.P); \
|
|
$(SED) -e 's/#.*//' -e 's/^.*: *//' -e 's/ *\\$$//' \
|
|
-e '/^$$/ d' -e 's/$$/ :/' < $(@:.o=.d) >> $(@:.o=.P); \
|
|
$(RM) -f $(@:.o=.d)
|
|
endef
|
|
|
|
define compile_cxx
|
|
$(ECHO) "CXX $<"
|
|
$(Q)$(CXX) $(CXXFLAGS) -c -MD -MF $(@:.o=.d) -o $@ $< || (echo -e $(HELP_BUILD_ERROR); false)
|
|
@# The following fixes the dependency file.
|
|
@# See http://make.paulandlesley.org/autodep.html for details.
|
|
@# Regex adjusted from the above to play better with Windows paths, etc.
|
|
@$(CP) $(@:.o=.d) $(@:.o=.P); \
|
|
$(SED) -e 's/#.*//' -e 's/^.*: *//' -e 's/ *\\$$//' \
|
|
-e '/^$$/ d' -e 's/$$/ :/' < $(@:.o=.d) >> $(@:.o=.P); \
|
|
$(RM) -f $(@:.o=.d)
|
|
endef
|
|
|
|
vpath %.c . $(TOP) $(USER_C_MODULES)
|
|
$(BUILD)/%.o: %.c
|
|
$(call compile_c)
|
|
|
|
vpath %.cpp . $(TOP) $(USER_C_MODULES)
|
|
$(BUILD)/%.o: %.cpp
|
|
$(call compile_cxx)
|
|
|
|
$(BUILD)/%.pp: %.c
|
|
$(ECHO) "PreProcess $<"
|
|
$(Q)$(CPP) $(CFLAGS) -Wp,-C,-dD,-dI -o $@ $<
|
|
|
|
# Special case for compiling auto-generated source files.
|
|
$(BUILD)/%.o: $(BUILD)/%.c
|
|
$(call compile_c)
|
|
|
|
# The following rule uses | to create an order only prerequisite. Order only
|
|
# prerequisites only get built if they don't exist. They don't cause timestamp
|
|
# checking to be performed.
|
|
#
|
|
# We don't know which source files actually need the generated.h (since
|
|
# it is #included from str.h). The compiler generated dependencies will cause
|
|
# the right .o's to get recompiled if the generated.h file changes. Adding
|
|
# an order-only dependency to all of the .o's will cause the generated .h
|
|
# to get built before we try to compile any of them.
|
|
$(OBJ): | $(HEADER_BUILD)/qstrdefs.generated.h $(HEADER_BUILD)/mpversion.h $(OBJ_EXTRA_ORDER_DEPS)
|
|
|
|
# The logic for qstr regeneration (applied by makeqstrdefs.py) is:
|
|
# - if anything in QSTR_GLOBAL_DEPENDENCIES is newer, then process all source files ($^)
|
|
# - else, if list of newer prerequisites ($?) is not empty, then process just these ($?)
|
|
# - else, process all source files ($^) [this covers "make -B" which can set $? to empty]
|
|
# See more information about this process in docs/develop/qstr.rst.
|
|
$(HEADER_BUILD)/qstr.i.last: $(SRC_QSTR) $(QSTR_GLOBAL_DEPENDENCIES) | $(QSTR_GLOBAL_REQUIREMENTS)
|
|
$(ECHO) "GEN $@"
|
|
$(Q)$(PYTHON) $(PY_SRC)/makeqstrdefs.py pp $(CPP) output $(HEADER_BUILD)/qstr.i.last cflags $(QSTR_GEN_CFLAGS) cxxflags $(QSTR_GEN_CXXFLAGS) sources $^ dependencies $(QSTR_GLOBAL_DEPENDENCIES) changed_sources $?
|
|
|
|
$(HEADER_BUILD)/qstr.split: $(HEADER_BUILD)/qstr.i.last
|
|
$(ECHO) "GEN $@"
|
|
$(Q)$(PYTHON) $(PY_SRC)/makeqstrdefs.py split qstr $< $(HEADER_BUILD)/qstr _
|
|
$(Q)$(TOUCH) $@
|
|
|
|
$(QSTR_DEFS_COLLECTED): $(HEADER_BUILD)/qstr.split
|
|
$(ECHO) "GEN $@"
|
|
$(Q)$(PYTHON) $(PY_SRC)/makeqstrdefs.py cat qstr _ $(HEADER_BUILD)/qstr $@
|
|
|
|
# Module definitions via MP_REGISTER_MODULE.
|
|
$(HEADER_BUILD)/moduledefs.split: $(HEADER_BUILD)/qstr.i.last
|
|
$(ECHO) "GEN $@"
|
|
$(Q)$(PYTHON) $(PY_SRC)/makeqstrdefs.py split module $< $(HEADER_BUILD)/module _
|
|
$(Q)$(TOUCH) $@
|
|
|
|
$(HEADER_BUILD)/moduledefs.collected: $(HEADER_BUILD)/moduledefs.split
|
|
$(ECHO) "GEN $@"
|
|
$(Q)$(PYTHON) $(PY_SRC)/makeqstrdefs.py cat module _ $(HEADER_BUILD)/module $@
|
|
|
|
# Module definitions via MP_REGISTER_ROOT_POINTER.
|
|
$(HEADER_BUILD)/root_pointers.split: $(HEADER_BUILD)/qstr.i.last
|
|
$(ECHO) "GEN $@"
|
|
$(Q)$(PYTHON) $(PY_SRC)/makeqstrdefs.py split root_pointer $< $(HEADER_BUILD)/root_pointer _
|
|
$(Q)$(TOUCH) $@
|
|
|
|
$(HEADER_BUILD)/root_pointers.collected: $(HEADER_BUILD)/root_pointers.split
|
|
$(ECHO) "GEN $@"
|
|
$(Q)$(PYTHON) $(PY_SRC)/makeqstrdefs.py cat root_pointer _ $(HEADER_BUILD)/root_pointer $@
|
|
|
|
# Compressed error strings.
|
|
$(HEADER_BUILD)/compressed.split: $(HEADER_BUILD)/qstr.i.last
|
|
$(ECHO) "GEN $@"
|
|
$(Q)$(PYTHON) $(PY_SRC)/makeqstrdefs.py split compress $< $(HEADER_BUILD)/compress _
|
|
$(Q)$(TOUCH) $@
|
|
|
|
$(HEADER_BUILD)/compressed.collected: $(HEADER_BUILD)/compressed.split
|
|
$(ECHO) "GEN $@"
|
|
$(Q)$(PYTHON) $(PY_SRC)/makeqstrdefs.py cat compress _ $(HEADER_BUILD)/compress $@
|
|
|
|
# $(sort $(var)) removes duplicates
|
|
#
|
|
# The net effect of this, is it causes the objects to depend on the
|
|
# object directories (but only for existence), and the object directories
|
|
# will be created if they don't exist.
|
|
OBJ_DIRS = $(sort $(dir $(OBJ)))
|
|
$(OBJ): | $(OBJ_DIRS)
|
|
$(OBJ_DIRS):
|
|
$(MKDIR) -p $@
|
|
|
|
$(HEADER_BUILD):
|
|
$(MKDIR) -p $@
|
|
|
|
ifneq ($(MICROPY_MPYCROSS_DEPENDENCY),)
|
|
# to automatically build mpy-cross, if needed
|
|
$(MICROPY_MPYCROSS_DEPENDENCY):
|
|
$(MAKE) -C "$(abspath $(dir $@)..)"
|
|
endif
|
|
|
|
ifneq ($(FROZEN_DIR),)
|
|
$(error Support for FROZEN_DIR was removed. Please use manifest.py instead, see https://docs.micropython.org/en/latest/reference/manifest.html)
|
|
endif
|
|
|
|
ifneq ($(FROZEN_MPY_DIR),)
|
|
$(error Support for FROZEN_MPY_DIR was removed. Please use manifest.py instead, see https://docs.micropython.org/en/latest/reference/manifest.html)
|
|
endif
|
|
|
|
ifneq ($(FROZEN_MANIFEST),)
|
|
# If we're using the default submodule path for micropython-lib, then make
|
|
# sure it's included in "make submodules".
|
|
ifeq ($(MPY_LIB_DIR),$(MPY_LIB_SUBMODULE_DIR))
|
|
GIT_SUBMODULES += lib/micropython-lib
|
|
endif
|
|
|
|
# Set compile options needed to enable frozen code.
|
|
CFLAGS += -DMICROPY_QSTR_EXTRA_POOL=mp_qstr_frozen_const_pool
|
|
CFLAGS += -DMICROPY_MODULE_FROZEN_MPY
|
|
CFLAGS += -DMICROPY_MODULE_FROZEN_STR
|
|
|
|
# Set default path variables to be passed to makemanifest.py. These will be
|
|
# available in path substitutions. Additional variables can be set per-board
|
|
# in mpconfigboard.mk or on the make command line.
|
|
MICROPY_MANIFEST_MPY_LIB_DIR = $(MPY_LIB_DIR)
|
|
MICROPY_MANIFEST_PORT_DIR = $(shell pwd)
|
|
MICROPY_MANIFEST_BOARD_DIR = $(BOARD_DIR)
|
|
MICROPY_MANIFEST_MPY_DIR = $(TOP)
|
|
|
|
# Find all MICROPY_MANIFEST_* variables and turn them into command line arguments.
|
|
MANIFEST_VARIABLES = $(foreach var,$(filter MICROPY_MANIFEST_%, $(.VARIABLES)),-v "$(subst MICROPY_MANIFEST_,,$(var))=$($(var))")
|
|
|
|
# to build frozen_content.c from a manifest
|
|
$(BUILD)/frozen_content.c: FORCE $(BUILD)/genhdr/qstrdefs.generated.h $(BUILD)/genhdr/root_pointers.h | $(MICROPY_MPYCROSS_DEPENDENCY)
|
|
$(Q)test -e "$(MPY_LIB_DIR)/README.md" || (echo -e $(HELP_MPY_LIB_SUBMODULE); false)
|
|
$(Q)$(MAKE_MANIFEST) -o $@ $(MANIFEST_VARIABLES) -b "$(BUILD)" $(if $(MPY_CROSS_FLAGS),-f"$(MPY_CROSS_FLAGS)",) --mpy-tool-flags="$(MPY_TOOL_FLAGS)" $(FROZEN_MANIFEST)
|
|
endif
|
|
|
|
ifneq ($(PROG),)
|
|
# Build a standalone executable (unix does this)
|
|
|
|
# The executable should have an .exe extension for builds targeting 'pure'
|
|
# Windows, i.e. msvc or mingw builds, but not when using msys or cygwin's gcc.
|
|
COMPILER_TARGET := $(shell $(CC) -dumpmachine)
|
|
ifneq (,$(findstring mingw,$(COMPILER_TARGET)))
|
|
PROG := $(PROG).exe
|
|
endif
|
|
|
|
all: $(BUILD)/$(PROG)
|
|
|
|
$(BUILD)/$(PROG): $(OBJ)
|
|
$(ECHO) "LINK $@"
|
|
# Do not pass COPT here - it's *C* compiler optimizations. For example,
|
|
# we may want to compile using Thumb, but link with non-Thumb libc.
|
|
$(Q)$(CC) -o $@ $^ $(LIB) $(LDFLAGS)
|
|
ifndef DEBUG
|
|
ifdef STRIP
|
|
$(Q)$(STRIP) $(STRIPFLAGS_EXTRA) $@
|
|
endif
|
|
endif
|
|
$(Q)$(SIZE) $$(find $(BUILD) -path "$(BUILD)/build/frozen*.o") $@
|
|
|
|
clean: clean-prog
|
|
clean-prog:
|
|
$(RM) -f $(BUILD)/$(PROG)
|
|
$(RM) -f $(BUILD)/$(PROG).map
|
|
|
|
.PHONY: clean-prog
|
|
endif
|
|
|
|
submodules:
|
|
$(ECHO) "Updating submodules: $(GIT_SUBMODULES)"
|
|
ifneq ($(GIT_SUBMODULES),)
|
|
$(Q)git submodule sync $(addprefix $(TOP)/,$(GIT_SUBMODULES))
|
|
$(Q)git submodule update --init $(addprefix $(TOP)/,$(GIT_SUBMODULES))
|
|
endif
|
|
.PHONY: submodules
|
|
|
|
LIBMICROPYTHON = libmicropython.a
|
|
|
|
# We can execute extra commands after library creation using
|
|
# LIBMICROPYTHON_EXTRA_CMD. This may be needed e.g. to integrate
|
|
# with 3rd-party projects which don't have proper dependency
|
|
# tracking. Then LIBMICROPYTHON_EXTRA_CMD can e.g. touch some
|
|
# other file to cause needed effect, e.g. relinking with new lib.
|
|
lib $(BUILD)/$(LIBMICROPYTHON): $(OBJ)
|
|
$(Q)$(AR) rcs $(BUILD)/$(LIBMICROPYTHON) $^
|
|
$(LIBMICROPYTHON_EXTRA_CMD)
|
|
|
|
clean:
|
|
$(RM) -rf $(BUILD) $(CLEAN_EXTRA)
|
|
.PHONY: clean
|
|
|
|
print-cfg:
|
|
$(ECHO) "PY_SRC = $(PY_SRC)"
|
|
$(ECHO) "BUILD = $(BUILD)"
|
|
$(ECHO) "OBJ = $(OBJ)"
|
|
.PHONY: print-cfg
|
|
|
|
print-def:
|
|
@$(ECHO) "The following defines are built into the $(CC) compiler"
|
|
$(TOUCH) __empty__.c
|
|
@$(CC) -E -Wp,-dM __empty__.c
|
|
@$(RM) -f __empty__.c
|
|
|
|
-include $(OBJ:.o=.P)
|