mirror
/
micropython
kopia lustrzana https://github.com/micropython/micropython
1
0
Forkuj 0
Kod Zgłoszenia Projekty Wydania Wiki Aktywność
micropython/ports/minimal/Makefile

107 wiersze
2.8 KiB
Makefile
Czysty Zwykły widok Historia

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 04:09:13 +00: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 02:22:19 +00: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 15:22:16 +00: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 02:22:19 +00: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 02:22:19 +00: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 11:59:11 +00:00
CFLAGS_CORTEX_M4 = -mthumb -mtune=cortex-m4 -mcpu=cortex-m4 -msoft-float -fsingle-precision-constant -Wdouble-promotion -Wfloat-conversion
all: Use += rather than = everywhere for CFLAGS/LDFLAGS/LIBS. This avoids a surprise where an = can cancel out an earlier +=. Signed-off-by: Jim Mussared <jim.mussared@gmail.com>
2022-10-08 12:08:53 +00:00
CFLAGS += $(INC) -Wall -Werror -std=c99 -nostdlib $(CFLAGS_CORTEX_M4) $(COPT)
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: Set linker to $(CC). Changed 'LD = gcc' too 'LD = $(CC)' to support other compilers. Signed-off-by: Jan Willeke <willeke@smartmote.de>
2022-01-10 12:53:44 +00:00
LD = $(CC)
all: Use += rather than = everywhere for CFLAGS/LDFLAGS/LIBS. This avoids a surprise where an = can cancel out an earlier +=. Signed-off-by: Jim Mussared <jim.mussared@gmail.com>
2022-10-08 12:08:53 +00:00
CFLAGS += $(INC) -Wall -Werror -Wdouble-promotion -Wfloat-conversion -std=c99 $(COPT)
LDFLAGS += -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 12:14:51 +00:00
CSUPEROPT = -Os # save some code space
minimal/Makefile: Enable gc-sections to remove unused code.
2017-07-19 02:21:52 +00:00
# Tune for Debugging or Optimization
ports: Always include debug information in the ELF. For bare metal ARM & xtensa targets, passing -g will make the ELF file larger but doesn't change the binary size. However, this means tools like gdb, addr2line, etc can extract source-level information from the ELF. Also standardise -ggdb to -g, these produce the exact same ELF file on arm-none-eabi-gcc and will use DWARF format for all these ports.
2022-07-28 07:56:27 +00:00
CFLAGS += -g # always include debug info in the ELF
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)
ports: Always include debug information in the ELF. For bare metal ARM & xtensa targets, passing -g will make the ELF file larger but doesn't change the binary size. However, this means tools like gdb, addr2line, etc can extract source-level information from the ELF. Also standardise -ggdb to -g, these produce the exact same ELF file on arm-none-eabi-gcc and will use DWARF format for all these ports.
2022-07-28 07:56:27 +00:00
CFLAGS += -O0
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
else
CFLAGS += -Os -DNDEBUG
minimal/Makefile: Enable gc-sections to remove unused code.
2017-07-19 02:21:52 +00: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
minimal/Makefile: Add support for building with user C modules. Fixes issue #5750. Signed-off-by: Damien George <damien@micropython.org>
2021-07-23 02:02:03 +00:00
# Flags for optional C++ source code
CXXFLAGS += $(filter-out -std=c99,$(CFLAGS))
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
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 \
all: Update to point to files in new shared/ directory. Signed-off-by: Damien George <damien@micropython.org>
2021-07-09 04:19:15 +00:00
shared/libc/printf.c \
shared/readline/readline.c \
shared/runtime/pyexec.c \
shared/runtime/stdout_helpers.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 21:35:19 +00:00
ifeq ($(CROSS), 1)
all: Update to point to files in new shared/ directory. Signed-off-by: Damien George <damien@micropython.org>
2021-07-09 04:19:15 +00:00
SRC_C += shared/libc/string0.c
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 21:35:19 +00:00
endif
shared/runtime/pyexec: Use MP_REGISTER_ROOT_POINTER(). This uses MP_REGISTER_ROOT_POINTER() to register repl_line instead of using a conditional inside of mp_state_vm_t. Signed-off-by: David Lechner <david@pybricks.com>
2022-07-02 20:05:41 +00:00
SRC_QSTR += shared/readline/readline.c shared/runtime/pyexec.c
minimal/Makefile: Add support for building with user C modules. Fixes issue #5750. Signed-off-by: Damien George <damien@micropython.org>
2021-07-23 02:02:03 +00:00
extmod: Make extmod.mk self-contained. This makes it so that all a port needs to do is set the relevant variables and "include extmod.mk" and doesn't need to worry about adding anything to OBJ, CFLAGS, SRC_QSTR, etc. Make all extmod variables (src, flags, etc) private to extmod.mk. Also move common/shared, extmod-related fragments (e.g. wiznet, cyw43, bluetooth) into extmod.mk. Now that SRC_MOD, CFLAGS_MOD, CXXFLAGS_MOD are unused by both extmod.mk (and user-C-modules in a previous commit), remove all uses of them from port makefiles. Signed-off-by: Jim Mussared <jim.mussared@gmail.com>
2022-10-08 12:59:08 +00:00
OBJ += $(PY_CORE_O)
OBJ += $(addprefix $(BUILD)/, $(SRC_C:.c=.o))
minimal/Makefile: Add support for building with user C modules. Fixes issue #5750. Signed-off-by: Damien George <damien@micropython.org>
2021-07-23 02:02:03 +00:00
OBJ += $(addprefix $(BUILD)/, $(SRC_CXX:.cpp=.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
tests/frozen: Move frozentest.mpy from ports/ to tests/. frozentest.mpy was previously duplicated in ports/minimal and ports/powerpc. This needs to be re-generated on every .mpy version increase, so might as well just have a single copy of it. Signed-off-by: Jim Mussared <jim.mussared@gmail.com>
2022-09-19 02:03:38 +00:00
$(BUILD)/_frozen_mpy.c: $(TOP)/tests/frozen/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 02:22:19 +00: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-23 23:26:10 +00: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 19:01:44 +00: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 19:01:44 +00: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:
minimal/Makefile: Avoid terminal reset, use BUILD variable. stty can provide the current terminal settings, so that they can be stored in a shell variable and restored after running the firmware. This avoids the complete "blanking" of the terminal, and thus also removes the need for the sleep call. The run target now references the firmware file using the BUILD variable instead of using the hard coded "build/" path.
2022-07-31 16:01:13 +00:00
@saved_=`stty -g`; \
stty raw opost -echo; \
$(BUILD)/firmware.elf; \
echo "Exit status: $$?"; \
stty $$saved_
minimal: Add "run" make target to run emulated build with suitable tty config.
2015-01-13 02:07:03 +00:00
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 02:22:19 +00:00
include $(TOP)/py/mkrules.mk