mirrors
/
micropython
mirror of https://github.com/micropython/micropython.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
micropython/ports/minimal/Makefile

100 lines
2.5 KiB
Makefile
Raw Normal View History

all: Update Makefiles and others to build with new ports/ dir layout. Also renames "stmhal" to "stm32" in documentation and everywhere else.
2017-09-06 05:09:13 +01:00
include ../../py/mkenv.mk
minimal: New port, intended to represent minimal working code. Unlike bare-arm, which is mostly intended to show raw interpreter size, without library and support code dependencies. This port is intended to be a better base to start new ports, and also will include emulation build to allow debug some aspects of embedded targets on POSIX systems. This initial commit is verbatim copy of bare-arm code.
2015-01-13 01:17:47 +00:00
minimal: Convert "bare-arm" port to "minimal" port. This enable libc functions, GC, and line-editing function. Also, UART emulation for POSIX systems is added. Emulation build is set as default.
2015-01-13 02:02:56 +00:00
CROSS = 0
minimal: New port, intended to represent minimal working code. Unlike bare-arm, which is mostly intended to show raw interpreter size, without library and support code dependencies. This port is intended to be a better base to start new ports, and also will include emulation build to allow debug some aspects of embedded targets on POSIX systems. This initial commit is verbatim copy of bare-arm code.
2015-01-13 01:17:47 +00:00
# qstr definitions (must come before including py.mk)
QSTR_DEFS = qstrdefsport.h
ports: Enable error text compression for various ports, but not all. Enabled on: bare-arm, minimal, unix coverage/dev/minimal, stm32, esp32, esp8266, cc3200, teensy, qemu-arm, nrf. Not enabled on others to be able to test the code when the feature is disabled (the default case). Code size change for this commit: bare-arm: -600 -0.906% minimal x86: -308 -0.208% unix x64: +0 +0.000% unix nanbox: +0 +0.000% stm32: -3368 -0.869% PYBV10 cc3200: -1024 -0.558% esp8266: -2512 -0.368% GENERIC esp32: -2876 -0.205% GENERIC[incl -3168(data)] nrf: -1708 -1.173% pca10040 samd: +0 +0.000% ADAFRUIT_ITSYBITSY_M4_EXPRESS
2020-03-04 10:56:44 +00:00
# MicroPython feature configurations
MICROPY_ROM_TEXT_COMPRESSION ?= 1
minimal: New port, intended to represent minimal working code. Unlike bare-arm, which is mostly intended to show raw interpreter size, without library and support code dependencies. This port is intended to be a better base to start new ports, and also will include emulation build to allow debug some aspects of embedded targets on POSIX systems. This initial commit is verbatim copy of bare-arm code.
2015-01-13 01:17:47 +00:00
# include py core make definitions
all: Make use of $(TOP) variable in Makefiles, instead of "..". $(TOP) is defined in py/mkenv.mk and should be used to refer to the top level of this repository.
2017-08-11 03:22:19 +01:00
include $(TOP)/py/py.mk
minimal: New port, intended to represent minimal working code. Unlike bare-arm, which is mostly intended to show raw interpreter size, without library and support code dependencies. This port is intended to be a better base to start new ports, and also will include emulation build to allow debug some aspects of embedded targets on POSIX systems. This initial commit is verbatim copy of bare-arm code.
2015-01-13 01:17:47 +00:00
minimal: Convert "bare-arm" port to "minimal" port. This enable libc functions, GC, and line-editing function. Also, UART emulation for POSIX systems is added. Emulation build is set as default.
2015-01-13 02:02:56 +00:00
ifeq ($(CROSS), 1)
ports: Allow overriding CROSS_COMPILE in a custom makefile. Many ports already allow overriding CROSS_COMPILE. This modifies the remaining ports to allow it as well.
2019-12-21 20:22:26 +00:00
CROSS_COMPILE ?= arm-none-eabi-
minimal: Convert "bare-arm" port to "minimal" port. This enable libc functions, GC, and line-editing function. Also, UART emulation for POSIX systems is added. Emulation build is set as default.
2015-01-13 02:02:56 +00:00
endif
minimal: New port, intended to represent minimal working code. Unlike bare-arm, which is mostly intended to show raw interpreter size, without library and support code dependencies. This port is intended to be a better base to start new ports, and also will include emulation build to allow debug some aspects of embedded targets on POSIX systems. This initial commit is verbatim copy of bare-arm code.
2015-01-13 01:17:47 +00:00
all: Make netutils.h available to all ports by default. Generally, ports should inherit INC from py.mk, append to it, not overwrite it. TODO: Likely should do the same for other vars too.
2015-10-19 16:22:16 +01:00
INC += -I.
all: Make use of $(TOP) variable in Makefiles, instead of "..". $(TOP) is defined in py/mkenv.mk and should be used to refer to the top level of this repository.
2017-08-11 03:22:19 +01:00
INC += -I$(TOP)
minimal: New port, intended to represent minimal working code. Unlike bare-arm, which is mostly intended to show raw interpreter size, without library and support code dependencies. This port is intended to be a better base to start new ports, and also will include emulation build to allow debug some aspects of embedded targets on POSIX systems. This initial commit is verbatim copy of bare-arm code.
2015-01-13 01:17:47 +00:00
INC += -I$(BUILD)
minimal: Convert "bare-arm" port to "minimal" port. This enable libc functions, GC, and line-editing function. Also, UART emulation for POSIX systems is added. Emulation build is set as default.
2015-01-13 02:02:56 +00:00
ifeq ($(CROSS), 1)
all: Make use of $(TOP) variable in Makefiles, instead of "..". $(TOP) is defined in py/mkenv.mk and should be used to refer to the top level of this repository.
2017-08-11 03:22:19 +01:00
DFU = $(TOP)/tools/dfu.py
PYDFU = $(TOP)/tools/pydfu.py
all: Enable extra conversion warnings where applicable. Add -Wdouble-promotion and -Wfloat-conversion for most ports to ban out implicit floating point conversions, and add extra Travis builds using MICROPY_FLOAT_IMPL_FLOAT to uncover warnings which weren't found previously. For the unix port -Wsign-comparison is added as well but only there since only clang supports this but gcc doesn't.
2020-04-09 12:59:11 +01:00
CFLAGS_CORTEX_M4 = -mthumb -mtune=cortex-m4 -mcpu=cortex-m4 -msoft-float -fsingle-precision-constant -Wdouble-promotion -Wfloat-conversion
minimal/Makefile: Change C standard from gnu99 to c99.
2017-03-23 04:41:38 +00:00
CFLAGS = $(INC) -Wall -Werror -std=c99 -nostdlib $(CFLAGS_CORTEX_M4) $(COPT)
minimal/Makefile: Enable gc-sections to remove unused code.
2017-07-19 03:21:52 +01:00
LDFLAGS = -nostdlib -T stm32f405.ld -Map=$@.map --cref --gc-sections
minimal: Convert "bare-arm" port to "minimal" port. This enable libc functions, GC, and line-editing function. Also, UART emulation for POSIX systems is added. Emulation build is set as default.
2015-01-13 02:02:56 +00:00
else
minimal/Makefile: Enable gc-sections to remove unused code.
2017-07-19 03:21:52 +01:00
LD = gcc
all: Enable extra conversion warnings where applicable. Add -Wdouble-promotion and -Wfloat-conversion for most ports to ban out implicit floating point conversions, and add extra Travis builds using MICROPY_FLOAT_IMPL_FLOAT to uncover warnings which weren't found previously. For the unix port -Wsign-comparison is added as well but only there since only clang supports this but gcc doesn't.
2020-04-09 12:59:11 +01:00
CFLAGS = -m32 $(INC) -Wall -Werror -Wdouble-promotion -Wfloat-conversion -std=c99 $(COPT)
minimal/Makefile: Enable gc-sections to remove unused code.
2017-07-19 03:21:52 +01:00
LDFLAGS = -m32 -Wl,-Map=$@.map,--cref -Wl,--gc-sections
minimal: Convert "bare-arm" port to "minimal" port. This enable libc functions, GC, and line-editing function. Also, UART emulation for POSIX systems is added. Emulation build is set as default.
2015-01-13 02:02:56 +00:00
endif
minimal: New port, intended to represent minimal working code. Unlike bare-arm, which is mostly intended to show raw interpreter size, without library and support code dependencies. This port is intended to be a better base to start new ports, and also will include emulation build to allow debug some aspects of embedded targets on POSIX systems. This initial commit is verbatim copy of bare-arm code.
2015-01-13 01:17:47 +00:00
bare-arm, minimal: Set CSUPEROPT=-Os to get minimal firmware size. This option affects py/vm.c and py/gc.c and using -Os gets them compiling a bit smaller, and small firmware is the aim of these two ports. Also, having these files compiled with -Os on these ports, and -O3 as the default on other ports, gives a better understanding of code-size changes when making changes to these files.
2019-09-12 13:14:51 +01:00
CSUPEROPT = -Os # save some code space
minimal/Makefile: Enable gc-sections to remove unused code.
2017-07-19 03:21:52 +01:00
# Tune for Debugging or Optimization
minimal: New port, intended to represent minimal working code. Unlike bare-arm, which is mostly intended to show raw interpreter size, without library and support code dependencies. This port is intended to be a better base to start new ports, and also will include emulation build to allow debug some aspects of embedded targets on POSIX systems. This initial commit is verbatim copy of bare-arm code.
2015-01-13 01:17:47 +00:00
ifeq ($(DEBUG), 1)
CFLAGS += -O0 -ggdb
else
CFLAGS += -Os -DNDEBUG
minimal/Makefile: Enable gc-sections to remove unused code.
2017-07-19 03:21:52 +01:00
CFLAGS += -fdata-sections -ffunction-sections
minimal: New port, intended to represent minimal working code. Unlike bare-arm, which is mostly intended to show raw interpreter size, without library and support code dependencies. This port is intended to be a better base to start new ports, and also will include emulation build to allow debug some aspects of embedded targets on POSIX systems. This initial commit is verbatim copy of bare-arm code.
2015-01-13 01:17:47 +00:00
endif
LIBS =
SRC_C = \
main.c \
minimal: Convert "bare-arm" port to "minimal" port. This enable libc functions, GC, and line-editing function. Also, UART emulation for POSIX systems is added. Emulation build is set as default.
2015-01-13 02:02:56 +00:00
uart_core.c \
minimal/Makefile: Explicitly include lib/utils/printf.c in build. The bare-metal port needs it and it's no longer included by default since the Makefile now uses $(PY_CORE_O).
2018-02-22 02:19:09 +00:00
lib/utils/printf.c \
lib/utils/stdout_helpers: Move from minimal/uart_extra.c for reuse.
2016-07-22 17:56:27 +01:00
lib/utils/stdout_helpers.c \
stmhal: pyexec.c is common module, move to lib/utils/ .
2015-10-31 16:35:10 +00:00
lib/utils/pyexec.c \
minimal: Convert "bare-arm" port to "minimal" port. This enable libc functions, GC, and line-editing function. Also, UART emulation for POSIX systems is added. Emulation build is set as default.
2015-01-13 02:02:56 +00:00
lib/mp-readline/readline.c \
minimal: Add example of frozen persistent bytecode (.mpy file). frozentest.py is frozen into the binary as frozen bytecode. The .mpy file is included so that there is no dependency on the cross compiler.
2016-01-31 22:16:41 +00:00
$(BUILD)/_frozen_mpy.c \
minimal: New port, intended to represent minimal working code. Unlike bare-arm, which is mostly intended to show raw interpreter size, without library and support code dependencies. This port is intended to be a better base to start new ports, and also will include emulation build to allow debug some aspects of embedded targets on POSIX systems. This initial commit is verbatim copy of bare-arm code.
2015-01-13 01:17:47 +00:00
minimal: Make build more flexible and work as 64-bit build. Changes are: - string0 is no longer built when building for host as the target, because it'll be provided by the system libc and may in some cases clash with the system one (eg on OSX). - mp_int_t/mp_uint_t are defined in terms of intptr_t/uintptr_t to support both 32-bit and 64-bit builds. - Configuration values which are the default in py/mpconfig.h are removed from mpconfigport.h to make the configuration a bit more minimal, eg as a better starting point for new ports.
2020-05-29 22:35:19 +01:00
ifeq ($(CROSS), 1)
SRC_C += lib/libc/string0.c
endif
ports/{bare-arm,minimal}/Makefile: Only build with core source files. These ports don't need anything from extmod so don't include those files at all in the build. This speeds up the build by about 10% when building with a single core.
2018-02-22 00:15:48 +00:00
OBJ = $(PY_CORE_O) $(addprefix $(BUILD)/, $(SRC_C:.c=.o))
minimal: New port, intended to represent minimal working code. Unlike bare-arm, which is mostly intended to show raw interpreter size, without library and support code dependencies. This port is intended to be a better base to start new ports, and also will include emulation build to allow debug some aspects of embedded targets on POSIX systems. This initial commit is verbatim copy of bare-arm code.
2015-01-13 01:17:47 +00:00
minimal: Add enough code to run minimal build on STM32F4xx hardware. Minimal support code for a Cortex-M CPU is added, along with set-up code for an STM32F4xx MCU, including a UART for a REPL. Tested on a pyboard. Code size is 77592 bytes.
2016-01-07 17:43:07 +00:00
ifeq ($(CROSS), 1)
all: $(BUILD)/firmware.dfu
else
minimal: New port, intended to represent minimal working code. Unlike bare-arm, which is mostly intended to show raw interpreter size, without library and support code dependencies. This port is intended to be a better base to start new ports, and also will include emulation build to allow debug some aspects of embedded targets on POSIX systems. This initial commit is verbatim copy of bare-arm code.
2015-01-13 01:17:47 +00:00
all: $(BUILD)/firmware.elf
minimal: Add enough code to run minimal build on STM32F4xx hardware. Minimal support code for a Cortex-M CPU is added, along with set-up code for an STM32F4xx MCU, including a UART for a REPL. Tested on a pyboard. Code size is 77592 bytes.
2016-01-07 17:43:07 +00:00
endif
minimal: New port, intended to represent minimal working code. Unlike bare-arm, which is mostly intended to show raw interpreter size, without library and support code dependencies. This port is intended to be a better base to start new ports, and also will include emulation build to allow debug some aspects of embedded targets on POSIX systems. This initial commit is verbatim copy of bare-arm code.
2015-01-13 01:17:47 +00:00
minimal: For frozen bytecode generation, add dependency of qstr file.
2016-04-16 13:05:47 +01:00
$(BUILD)/_frozen_mpy.c: frozentest.mpy $(BUILD)/genhdr/qstrdefs.generated.h
minimal: Add example of frozen persistent bytecode (.mpy file). frozentest.py is frozen into the binary as frozen bytecode. The .mpy file is included so that there is no dependency on the cross compiler.
2016-01-31 22:16:41 +00:00
$(ECHO) "MISC freezing bytecode"
all: Make use of $(TOP) variable in Makefiles, instead of "..". $(TOP) is defined in py/mkenv.mk and should be used to refer to the top level of this repository.
2017-08-11 03:22:19 +01:00
$(Q)$(TOP)/tools/mpy-tool.py -f -q $(BUILD)/genhdr/qstrdefs.preprocessed.h -mlongint-impl=none $< > $@
minimal: Add example of frozen persistent bytecode (.mpy file). frozentest.py is frozen into the binary as frozen bytecode. The .mpy file is included so that there is no dependency on the cross compiler.
2016-01-31 22:16:41 +00:00
minimal: New port, intended to represent minimal working code. Unlike bare-arm, which is mostly intended to show raw interpreter size, without library and support code dependencies. This port is intended to be a better base to start new ports, and also will include emulation build to allow debug some aspects of embedded targets on POSIX systems. This initial commit is verbatim copy of bare-arm code.
2015-01-13 01:17:47 +00:00
$(BUILD)/firmware.elf: $(OBJ)
$(ECHO) "LINK $@"
Makefiles: Remove duplicate object files when linking. Scenario: module1 depends on some common file from lib/, so specifies it in its SRC_MOD, and the same situation with module2, then common file from lib/ eventually ends up listed twice in $(OBJ), which leads to link errors. Make is equipped to deal with such situation easily, quoting the manual: "The value of $^ omits duplicate prerequisites, while $+ retains them and preserves their order." So, just use $^ consistently in all link targets.
2015-10-24 00:26:10 +01:00
$(Q)$(LD) $(LDFLAGS) -o $@ $^ $(LIBS)
minimal: New port, intended to represent minimal working code. Unlike bare-arm, which is mostly intended to show raw interpreter size, without library and support code dependencies. This port is intended to be a better base to start new ports, and also will include emulation build to allow debug some aspects of embedded targets on POSIX systems. This initial commit is verbatim copy of bare-arm code.
2015-01-13 01:17:47 +00:00
$(Q)$(SIZE) $@
minimal/Makefile: Split rule for firmware.bin generation.
2016-10-22 20:01:44 +01:00
$(BUILD)/firmware.bin: $(BUILD)/firmware.elf
minimal: Add enough code to run minimal build on STM32F4xx hardware. Minimal support code for a Cortex-M CPU is added, along with set-up code for an STM32F4xx MCU, including a UART for a REPL. Tested on a pyboard. Code size is 77592 bytes.
2016-01-07 17:43:07 +00:00
$(Q)$(OBJCOPY) -O binary -j .isr_vector -j .text -j .data $^ $(BUILD)/firmware.bin
minimal/Makefile: Split rule for firmware.bin generation.
2016-10-22 20:01:44 +01:00
$(BUILD)/firmware.dfu: $(BUILD)/firmware.bin
$(ECHO) "Create $@"
minimal: Add enough code to run minimal build on STM32F4xx hardware. Minimal support code for a Cortex-M CPU is added, along with set-up code for an STM32F4xx MCU, including a UART for a REPL. Tested on a pyboard. Code size is 77592 bytes.
2016-01-07 17:43:07 +00:00
$(Q)$(PYTHON) $(DFU) -b 0x08000000:$(BUILD)/firmware.bin $@
deploy: $(BUILD)/firmware.dfu
$(ECHO) "Writing $< to the board"
$(Q)$(PYTHON) $(PYDFU) -u $<
minimal: Add "run" make target to run emulated build with suitable tty config.
2015-01-13 02:07:03 +00:00
# Run emulation build on a POSIX system with suitable terminal settings
run:
stty raw opost -echo
build/firmware.elf
@echo Resetting terminal...
# This sleep is useful to spot segfaults
sleep 1
reset
minimal: Add simple test; build and run minimal test on Travis CI.
2015-01-13 12:39:29 +00:00
test: $(BUILD)/firmware.elf
travis, minimal: Install gcc-multilib for -m32; use /bin/echo for test.
2015-01-14 00:26:39 +00:00
$(Q)/bin/echo -e "print('hello world!', list(x+1 for x in range(10)), end='eol\\\\n')\\r\\n\\x04" | $(BUILD)/firmware.elf | tail -n2 | grep "^hello world! \\[1, 2, 3, 4, 5, 6, 7, 8, 9, 10\\]eol"
minimal: Add simple test; build and run minimal test on Travis CI.
2015-01-13 12:39:29 +00:00
all: Make use of $(TOP) variable in Makefiles, instead of "..". $(TOP) is defined in py/mkenv.mk and should be used to refer to the top level of this repository.
2017-08-11 03:22:19 +01:00
include $(TOP)/py/mkrules.mk