djsundog
/
circuitpython
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
circuitpython/py/mkenv.mk

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

74 lines
1.7 KiB
Makefile
Raw Normal View History

Rework makefiles. Add proper dependency checking.
2014-01-24 04:05:30 -05:00
ifneq ($(lastword a b),b)
$(error These Makefiles require make 3.81 or newer)
endif
# Set TOP to be the path to get from the current directory (where make was
# invoked) to the top of the tree. $(lastword $(MAKEFILE_LIST)) returns
# the name of this makefile relative to where make was invoked.
#
# We assume that this file is in the py directory so we use $(dir ) twice
# to get to the top of the tree.
THIS_MAKEFILE := $(lastword $(MAKEFILE_LIST))
TOP := $(patsubst %/py/mkenv.mk,%,$(THIS_MAKEFILE))
# Turn on increased build verbosity by defining BUILD_VERBOSE in your main
# Makefile or in your environment. You can also use V=1 on the make command
# line.
ifeq ("$(origin V)", "command line")
BUILD_VERBOSE=$(V)
endif
ifndef BUILD_VERBOSE
py/mkenv.mk: Don't emit info about BUILD_VERBOSE if it's set. If the user sets V or BUILD_VERBOSE then they don't need to see this message. Signed-off-by: Damien George <damien@micropython.org>
2021-05-11 21:18:16 -04:00
$(info Use make V=1 or set BUILD_VERBOSE in your environment to increase build verbosity.)
Rework makefiles. Add proper dependency checking.
2014-01-24 04:05:30 -05:00
BUILD_VERBOSE = 0
endif
ifeq ($(BUILD_VERBOSE),0)
Q = @
else
Q =
endif
various: Spelling fixes
2017-05-29 03:08:14 -04:00
# default settings; can be overridden in main Makefile
Rework makefiles. Add proper dependency checking.
2014-01-24 04:05:30 -05:00
PY_SRC ?= $(TOP)/py
BUILD ?= build
RM = rm
ECHO = @echo
Replace some Makefile commands with variables in py/mkenv.mk
2014-04-06 20:35:45 -04:00
CP = cp
MKDIR = mkdir
SED = sed
py: Update makefiles to use $(CAT) variable instead of hard coded "cat". The variable $(CAT) is initialised with the "cat" value in mkenv.mk like for the other command line tools (rm, echo, cp, mkdir etc). With this, for example, Windows users can specify the path of cat.exe.
2019-05-20 12:47:23 -04:00
CAT = cat
py: Update makefiles to use $(TOUCH) instead of hard coded "touch". The variable $(TOUCH) is initialized with the "touch" value in mkenv.mk like for the other command line tools (rm, echo, cp, mkdir etc). With this, for example, Windows users can specify the path of touch.exe.
2019-05-21 05:35:09 -04:00
TOUCH = touch
py/mkenv.mk: Change default PYTHON variable from "python" to "python3". This change makes it so that python3 is required by default to build MicroPython. Python 2 can be used by specifying make PYTHON=python2. This comes about due to a recent-ish change to PEP 394 that makes the python command more optional than before (even with Python 2 installed); see https://github.com/python/peps/commit/cd59ec03c8ff1e75089d5872520cd0706774b35b#diff-1d22f7bd72cbc900670f058b1107d426 Since the command python is no longer required to be provided by a distribution we need to use either python2 or python3 as commands. And python3 seems the obvious choice.
2019-01-31 02:22:12 -05:00
PYTHON = python3
py, mk: Revert change where build variables set with ?=. ?= operator does not do delayed expansion (unlike =).
2014-06-07 08:14:45 -04:00
AS = $(CROSS_COMPILE)as
CC = $(CROSS_COMPILE)gcc
py: Treat -m32 flag as part of CC, LD, etc. Indeed, this flag efectively selects architecture target, and must consistently apply to all compiles and links, including 3rd-party libraries, unlike CFLAGS, which have MicroPython-specific setting.
2015-08-29 14:13:07 -04:00
CXX = $(CROSS_COMPILE)g++
py/mkenv.mk: Add GDB variable.
2019-09-05 08:59:06 -04:00
GDB = $(CROSS_COMPILE)gdb
py, mk: Revert change where build variables set with ?=. ?= operator does not do delayed expansion (unlike =).
2014-06-07 08:14:45 -04:00
LD = $(CROSS_COMPILE)ld
OBJCOPY = $(CROSS_COMPILE)objcopy
SIZE = $(CROSS_COMPILE)size
STRIP = $(CROSS_COMPILE)strip
py: Allow to to build MicroPython as a static library. The whole current port gets slurped into a static lib named "libmicropython.a". Maybe that's not ideal, but at least something to start with.
2015-10-12 07:42:05 -04:00
AR = $(CROSS_COMPILE)ar
Rework makefiles. Add proper dependency checking.
2014-01-24 04:05:30 -05:00
tools: Add mechanism to provide a manifest of frozen files. This introduces a new build variable FROZEN_MANIFEST which can be set to a manifest listing (written in Python) that describes the set of files to be frozen in to the firmware.
2019-09-09 10:49:02 -04:00
MAKE_MANIFEST = $(PYTHON) $(TOP)/tools/makemanifest.py
py/mkenv.mk: Use $(PYTHON) consistently when calling Python tools. Rationale: * Calling Python build tool scripts from makefiles should be done consistently using `python </path/to/script>`, instead of relying on the correct she-bang line in the script [1] and the executable bit on the script being set. This is more platform-independent. * The name/path of the Python executable should always be used via the makefile variable `PYTHON` set in `py/mkenv.mk`. This way it can be easily overwritten by the user with `make PYTHON=/path/to/my/python`. * The Python executable name should be part of the value of the makefile variable, which stands for the build tool command (e.g. `MAKE_FROZEN` and `MPY_TOOL`), not part of the command line where it is used. If a Python tool is substituted by another (non-python) program, no change to the Makefiles is necessary, except in `py/mkenv.mk`. * This also solves #3369 and #1616. [1] There are systems, where even the assumption that `/usr/bin/env` always exists, doesn't hold true, for example on Android (where otherwise the unix port compiles perfectly well).
2017-10-31 12:19:12 -04:00
MAKE_FROZEN = $(PYTHON) $(TOP)/tools/make-frozen.py
MPY_TOOL = $(PYTHON) $(TOP)/tools/mpy-tool.py
py: Move frozen modules rules from esp8266 port for reuse across ports. A port now just needs to define FROZEN_DIR var and add $(BUILD)/frozen.c to SRC_C to support frozen modules.
2016-09-17 13:57:43 -04:00
py/mkenv.mk: Use micropython-lib from submodule by default. Also adds micropython-lib to 'make submodules' when using a frozen manifest (for make and cmake). Signed-off-by: Jim Mussared <jim.mussared@gmail.com>
2022-07-08 01:00:33 -04:00
MPY_LIB_SUBMODULE_DIR = $(TOP)/lib/micropython-lib
MPY_LIB_DIR = $(MPY_LIB_SUBMODULE_DIR)
tools/makemanifest.py: Eval relative paths w.r.t. current manifest file. When loading a manifest file, e.g. by include(), it will chdir first to the directory of that manifest. This means that all file operations within a manifest are relative to that manifest's location. As a consequence of this, additional environment variables are needed to find absolute paths, so the following are added: $(MPY_LIB_DIR), $(PORT_DIR), $(BOARD_DIR). And rename $(MPY) to $(MPY_DIR) to be consistent. Existing manifests are updated to match.
2019-10-16 00:12:39 -04:00
py/mkrules: Automatically build mpy-cross if it doesn't exist. Commit 41739506589ec8397613c86d8f682fb7f86c0a9f removed automatic building of mpy-cross, which rebuilt it whenever any of its dependent source files changed. But needing to build mpy-cross, and not knowing how, is a frequent issue. This commit aims to help by automatically building mpy-cross only if it doesn't exist. For Makefiles it uses an order-only prerequisite, while for CMake it uses a custom command. If MICROPY_MPYCROSS (which is what makemanifest.py uses to locate the mpy-cross executable) is defined in the environment then automatic build will not be attempted, allowing a way to prevent this auto-build if needed. Thanks to Trammell Hudson aka @osresearch for the original idea; see #5760. Signed-off-by: Damien George <damien@micropython.org>
2021-08-03 08:30:15 -04:00
ifeq ($(MICROPY_MPYCROSS),)
all: Fix paths to mpy-cross and micropython binaries. Binaries built using the Make build system now no longer appear in the working directory of the build, but rather in the build directory. Thus some paths had to be adjusted.
2022-08-02 17:48:41 -04:00
MICROPY_MPYCROSS = $(TOP)/mpy-cross/build/mpy-cross
py/mkrules: Automatically build mpy-cross if it doesn't exist. Commit 41739506589ec8397613c86d8f682fb7f86c0a9f removed automatic building of mpy-cross, which rebuilt it whenever any of its dependent source files changed. But needing to build mpy-cross, and not knowing how, is a frequent issue. This commit aims to help by automatically building mpy-cross only if it doesn't exist. For Makefiles it uses an order-only prerequisite, while for CMake it uses a custom command. If MICROPY_MPYCROSS (which is what makemanifest.py uses to locate the mpy-cross executable) is defined in the environment then automatic build will not be attempted, allowing a way to prevent this auto-build if needed. Thanks to Trammell Hudson aka @osresearch for the original idea; see #5760. Signed-off-by: Damien George <damien@micropython.org>
2021-08-03 08:30:15 -04:00
MICROPY_MPYCROSS_DEPENDENCY = $(MICROPY_MPYCROSS)
endif
Rework makefiles. Add proper dependency checking.
2014-01-24 04:05:30 -05:00
all:
.PHONY: all
Have make remove targets if a recipie fails.
2014-04-16 11:09:59 -04:00
.DELETE_ON_ERROR:
Rework makefiles. Add proper dependency checking.
2014-01-24 04:05:30 -05:00
MKENV_INCLUDED = 1