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

289 lines
7.4 KiB
Makefile
Raw Normal View History

Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
# where py object files go (they have a name prefix to prevent filename clashes)
Rework makefiles. Add proper dependency checking.
2014-01-24 04:05:30 -05:00
PY_BUILD = $(BUILD)/py
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
build directory can now be renamed The autogenerated header files have been moved about, and an extra include dir has been added, which means you can give a custom BUILD=newbuilddir option to make, and everything "just works" Also tidied up the way the different Makefiles build their include- directory flags
2014-04-16 17:10:33 -04:00
# where autogenerated header files go
build: Simplify build directory layout by putting all headers in genhdr. Any generated headers go in $(BUILD)/genhdr/, and are #included as 'genhdr/xxx.h'.
2014-04-17 13:03:27 -04:00
HEADER_BUILD = $(BUILD)/genhdr
Revamp qstrs: they now include length and hash. Can now have null bytes in strings. Can define ROM qstrs per port using qstrdefsport.h
2014-01-21 16:40:13 -05:00
build directory can now be renamed The autogenerated header files have been moved about, and an extra include dir has been added, which means you can give a custom BUILD=newbuilddir option to make, and everything "just works" Also tidied up the way the different Makefiles build their include- directory flags
2014-04-16 17:10:33 -04:00
# file containing qstr defs for the core Python bit
Revamp qstrs: they now include length and hash. Can now have null bytes in strings. Can define ROM qstrs per port using qstrdefsport.h
2014-01-21 16:40:13 -05:00
PY_QSTR_DEFS = $(PY_SRC)/qstrdefs.h
py/py.mk: Add makefile variable for qstr autogeneration control. - any architecture may explicitely build with qstring make QSTR_AUTOGEN_DISABLE=1 autogeneration disabled and provide its own list of qstrings by the standard mechanisms (qstrdefsport.h).
2016-03-16 03:47:40 -04:00
# If qstr autogeneration is not disabled we specify the output header
# for all collected qstrings.
ifneq ($(QSTR_AUTOGEN_DISABLE),1)
py: Add rules for automated extraction of qstrs from sources. - add template rule that converts a specified source file into a qstring file - add special rule for generating a central header that contains all extracted/autogenerated strings - defined by QSTR_DEFS_COLLECTED variable. Each platform appends a list of sources that may contain qstrings into a new build variable: SRC_QSTR. Any autogenerated prerequisities are should be appened to SRC_QSTR_AUTO_DEPS variable. - remove most qstrings from py/qstrdefs, keep only qstrings that contain special characters - these cannot be easily detected in the sources without additional annotations - remove most manual qstrdefs, use qstrdef autogen for: py, cc3200, stmhal, teensy, unix, windows, pic16bit: - remove all micropython generic qstrdefs except for the special strings that contain special characters (e.g. /,+,<,> etc.) - remove all port specific qstrdefs except for special strings - append sources for qstr generation in platform makefiles (SRC_QSTR)
2016-03-10 04:22:41 -05:00
QSTR_DEFS_COLLECTED = $(HEADER_BUILD)/qstrdefs.collected.h
py/py.mk: Add makefile variable for qstr autogeneration control. - any architecture may explicitely build with qstring make QSTR_AUTOGEN_DISABLE=1 autogeneration disabled and provide its own list of qstrings by the standard mechanisms (qstrdefsport.h).
2016-03-16 03:47:40 -04:00
endif
py: Add rules for automated extraction of qstrs from sources. - add template rule that converts a specified source file into a qstring file - add special rule for generating a central header that contains all extracted/autogenerated strings - defined by QSTR_DEFS_COLLECTED variable. Each platform appends a list of sources that may contain qstrings into a new build variable: SRC_QSTR. Any autogenerated prerequisities are should be appened to SRC_QSTR_AUTO_DEPS variable. - remove most qstrings from py/qstrdefs, keep only qstrings that contain special characters - these cannot be easily detected in the sources without additional annotations - remove most manual qstrdefs, use qstrdef autogen for: py, cc3200, stmhal, teensy, unix, windows, pic16bit: - remove all micropython generic qstrdefs except for the special strings that contain special characters (e.g. /,+,<,> etc.) - remove all port specific qstrdefs except for special strings - append sources for qstr generation in platform makefiles (SRC_QSTR)
2016-03-10 04:22:41 -05:00
py/mkrules.mk: Add QSTR_GLOBAL_REQUIREMENTS variable for qstr auto-gen.
2019-09-11 01:47:52 -04:00
# Any files listed by these variables will cause a full regeneration of qstrs
# DEPENDENCIES: included in qstr processing; REQUIREMENTS: not included
py/mkrules.mk: Regenerate all qstrs when config files change. A port can define QSTR_GLOBAL_DEPENDENCIES to add extra files.
2018-06-09 01:23:13 -04:00
QSTR_GLOBAL_DEPENDENCIES += $(PY_SRC)/mpconfig.h mpconfigport.h
py/mkrules.mk: Add QSTR_GLOBAL_REQUIREMENTS variable for qstr auto-gen.
2019-09-11 01:47:52 -04:00
QSTR_GLOBAL_REQUIREMENTS += $(HEADER_BUILD)/mpversion.h
py/mkrules.mk: Regenerate all qstrs when config files change. A port can define QSTR_GLOBAL_DEPENDENCIES to add extra files.
2018-06-09 01:23:13 -04:00
Makefile: Allow to override "super optimization" options used for some files. To help with debugging issue like #510 for example.
2014-04-23 19:59:43 -04:00
# some code is performance bottleneck and compiled with other optimization options
CSUPEROPT = -O3
py/mkenv.mk: Move usage of 32-bit flags to py.mk. This allows ports/variants to configure MICROPY_FORCE_32BIT after including mkenv.mk, but before py.mk.
2019-10-22 20:56:37 -04:00
# Enable building 32-bit code on 64-bit host.
ifeq ($(MICROPY_FORCE_32BIT),1)
CC += -m32
CXX += -m32
LD += -m32
endif
py: Implement a module system for external, user C modules. This system makes it a lot easier to include external libraries as static, native modules in MicroPython. Simply pass USER_C_MODULES (like FROZEN_MPY_DIR) as a make parameter.
2018-06-14 09:57:29 -04:00
# External modules written in C.
ifneq ($(USER_C_MODULES),)
py/py.mk: Remove trailing spaces at end of line.
2019-08-27 02:37:43 -04:00
# pre-define USERMOD variables as expanded so that variables are immediate
py: Update and rework build system for including external C modules. How to use this feature is documented in docs/develop/cmodules.rst.
2018-12-12 00:50:55 -05:00
# expanded as they're added to them
py/py.mk: Remove trailing spaces at end of line.
2019-08-27 02:37:43 -04:00
SRC_USERMOD :=
py: Update and rework build system for including external C modules. How to use this feature is documented in docs/develop/cmodules.rst.
2018-12-12 00:50:55 -05:00
CFLAGS_USERMOD :=
LDFLAGS_USERMOD :=
$(foreach module, $(wildcard $(USER_C_MODULES)/*/micropython.mk), \
$(eval USERMOD_DIR = $(patsubst %/,%,$(dir $(module))))\
$(info Including User C Module from $(USERMOD_DIR))\
$(eval include $(module))\
)
SRC_MOD += $(patsubst $(USER_C_MODULES)/%.c,%.c,$(SRC_USERMOD))
CFLAGS_MOD += $(CFLAGS_USERMOD)
LDFLAGS_MOD += $(LDFLAGS_USERMOD)
py: Implement a module system for external, user C modules. This system makes it a lot easier to include external libraries as static, native modules in MicroPython. Simply pass USER_C_MODULES (like FROZEN_MPY_DIR) as a make parameter.
2018-06-14 09:57:29 -04:00
endif
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
# py object files
py/py.mk: Remove .. path component from list of extmod files. This just makes it a bit cleaner in the output of the build process: instead of "CC ../../py/../extmod/" there is now "CC ../../extmod/".
2018-02-21 19:32:31 -05:00
PY_CORE_O_BASENAME = $(addprefix py/,\
py: Put all global state together in state structures. This patch consolidates all global variables in py/ core into one place, in a global structure. Root pointers are all located together to make GC tracing easier and more efficient.
2015-01-01 18:30:53 -05:00
mpstate.o \
py/nlr: Factor out common NLR code to macro and generic funcs in nlr.c. Each NLR implementation (Thumb, x86, x64, xtensa, setjmp) duplicates a lot of the NLR code, specifically that dealing with pushing and popping the NLR pointer to maintain the linked-list of NLR buffers. This patch factors all of that code out of the specific implementations into generic functions in nlr.c, along with a helper macro in nlr.h. This eliminates duplicated code.
2017-12-28 00:46:30 -05:00
nlr.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
nlrx86.o \
nlrx64.o \
nlrthumb.o \
powerpc: Add initial port to bare metal PowerPC arch. Runs in microwatt (GHDL and FPGA) and qemu. Port done initially by Michael Neuling, with help from Anton Blanchard and Jordan Niethe.
2019-08-21 20:21:48 -04:00
nlrpowerpc.o \
py: Add NLR support for xtensa CPU.
2014-11-27 15:29:33 -05:00
nlrxtensa.o \
nlr: Add implementation using setjmp/longjmp. Having an optimized asm implementation is good, but if we want portability, that's it.
2014-04-16 17:16:45 -04:00
nlrsetjmp.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
malloc.o \
Factor and simplify Makefile's and mpconfig, part 2.
2014-01-07 10:20:33 -05:00
gc.o \
py: Introduce a Python stack for scoped allocation. This patch introduces the MICROPY_ENABLE_PYSTACK option (disabled by default) which enables a "Python stack" that allows to allocate and free memory in a scoped, or Last-In-First-Out (LIFO) way, similar to alloca(). A new memory allocation API is introduced along with this Py-stack. It includes both "local" and "nonlocal" LIFO allocation. Local allocation is intended to be equivalent to using alloca(), whereby the same function must free the memory. Nonlocal allocation is where another function may free the memory, so long as it's still LIFO. Follow-up patches will convert all uses of alloca() and VLA to the new scoped allocation API. The old behaviour (using alloca()) will still be available, but when MICROPY_ENABLE_PYSTACK is enabled then alloca() is no longer required or used. The benefits of enabling this option are (or will be once subsequent patches are made to convert alloca()/VLA): - Toolchains without alloca() can use this feature to obtain correct and efficient scoped memory allocation (compared to using the heap instead of alloca(), which is slower). - Even if alloca() is available, enabling the Py-stack gives slightly more efficient use of stack space when calling nested Python functions, due to the way that compilers implement alloca(). - Enabling the Py-stack with the stackless mode allows for even more efficient stack usage, as well as retaining high performance (because the heap is no longer used to build and destroy stackless code states). - With Py-stack and stackless enabled, Python-calling-Python is no longer recursive in the C mp_execute_bytecode function. The micropython.pystack_use() function is included to measure usage of the Python stack.
2017-11-26 07:28:40 -05:00
pystack.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
qstr.o \
vstr.o \
py: Overhaul and simplify printf/pfenv mechanism. Previous to this patch the printing mechanism was a bit of a tangled mess. This patch attempts to consolidate printing into one interface. All (non-debug) printing now uses the mp_print* family of functions, mainly mp_printf. All these functions take an mp_print_t structure as their first argument, and this structure defines the printing backend through the "print_strn" function of said structure. Printing from the uPy core can reach the platform-defined print code via two paths: either through mp_sys_stdout_obj (defined pert port) in conjunction with mp_stream_write; or through the mp_plat_print structure which uses the MP_PLAT_PRINT_STRN macro to define how string are printed on the platform. The former is only used when MICROPY_PY_IO is defined. With this new scheme printing is generally more efficient (less layers to go through, less arguments to pass), and, given an mp_print_t* structure, one can call mp_print_str for efficiency instead of mp_printf("%s", ...). Code size is also reduced by around 200 bytes on Thumb2 archs.
2015-04-09 18:56:15 -04:00
mpprint.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
unicode.o \
Add arbitrary precision integer support. Some functionality is still missing (eg and, or, bit shift), and some things are buggy (eg subtract).
2014-02-22 14:25:23 -05:00
mpz.o \
py: Factor out persistent-code reader into separate files. Implementations of persistent-code reader are provided for POSIX systems and systems using FatFS. Macros to use these are MICROPY_READER_POSIX and MICROPY_READER_FATFS respectively. If an alternative implementation is needed then a port can define the function mp_reader_new_file.
2016-11-16 00:04:57 -05:00
reader.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
lexer.o \
parse.o \
scope.o \
compile.o \
emitcommon.o \
emitbc.o \
py: Factor out common code from assemblers into asmbase.[ch]. All assemblers should "derive" from mp_asm_base_t.
2016-11-27 17:24:50 -05:00
asmbase.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
asmx64.o \
emitnx64.o \
py: Add support for emitting native x86 machine code.
2014-09-06 18:06:36 -04:00
asmx86.o \
emitnx86.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
asmthumb.o \
emitnthumb.o \
emitinlinethumb.o \
Basic native ARM emitter
2014-08-16 16:55:53 -04:00
asmarm.o \
emitnarm.o \
py: Integrate Xtensa assembler into native emitter. The config option MICROPY_EMIT_XTENSA can now be enabled to target the Xtensa architecture with @micropython.native and @micropython.viper decorators.
2016-12-09 00:39:39 -05:00
asmxtensa.o \
emitnxtensa.o \
py: Add inline Xtensa assembler. This patch adds the MICROPY_EMIT_INLINE_XTENSA option, which, when enabled, allows the @micropython.asm_xtensa decorator to be used. The following opcodes are currently supported (ax is a register, a0-a15): ret_n() callx0(ax) j(label) jx(ax) beqz(ax, label) bnez(ax, label) mov(ax, ay) movi(ax, imm) # imm can be full 32-bit, uses l32r if needed and_(ax, ay, az) or_(ax, ay, az) xor(ax, ay, az) add(ax, ay, az) sub(ax, ay, az) mull(ax, ay, az) l8ui(ax, ay, imm) l16ui(ax, ay, imm) l32i(ax, ay, imm) s8i(ax, ay, imm) s16i(ax, ay, imm) s32i(ax, ay, imm) l16si(ax, ay, imm) addi(ax, ay, imm) ball(ax, ay, label) bany(ax, ay, label) bbc(ax, ay, label) bbs(ax, ay, label) beq(ax, ay, label) bge(ax, ay, label) bgeu(ax, ay, label) blt(ax, ay, label) bnall(ax, ay, label) bne(ax, ay, label) bnone(ax, ay, label) Upon entry to the assembly function the registers a0, a12, a13, a14 are pushed to the stack and the stack pointer (a1) decreased by 16. Upon exit, these registers and the stack pointer are restored, and ret.n is executed to return to the caller (caller address is in a0). Note that the ABI for the Xtensa emitters is non-windowing.
2016-12-09 01:03:33 -05:00
emitinlinextensa.o \
py: Add new Xtensa-Windowed arch for native emitter. Enabled via the configuration MICROPY_EMIT_XTENSAWIN.
2019-09-12 23:15:12 -04:00
emitnxtensawin.o \
Rename formatfloat file; remove MICROPY_ENABLE_FLOAT from mpconfigport.h. MICROPY_ENABLE_FLOAT is automatically set in mpconfig.h if MICROPY_FLOAT_IMPL is set to a non-zero value.
2014-03-10 09:27:02 -04:00
formatfloat.o \
py: Implement bit-shift and not operations for mpz. Implement not, shl and shr in mpz library. Add function to create mpzs on the stack, used for memory efficiency when rhs is a small int. Factor out code to parse base-prefix of number into a dedicated function.
2014-03-01 14:50:50 -05:00
parsenumbase.o \
py: Put number parsing code together in parsenum.c.
2014-02-22 13:12:43 -05:00
parsenum.o \
py: Factor out code from runtime.c to emitglue.c.
2014-03-27 19:26:35 -04:00
emitglue.o \
py: Factor persistent code load/save funcs into persistentcode.[ch].
2016-11-15 19:55:41 -05:00
persistentcode.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
runtime.o \
py: Move call_function_*_protected() functions to py/ for reuse. They almost certainly needed by any C code which calls Python callbacks.
2016-04-25 12:28:12 -04:00
runtime_utils.o \
py: Add micropython.schedule() function and associated runtime code.
2017-02-16 02:05:06 -05:00
scheduler.o \
py: Move native glue code from runtime.c to new file nativeglue.c. This way, the native glue code is only compiled if native code is enabled (which makes complete sense; thanks to Paul Sokolovsky for the idea). Should fix issue #834.
2014-08-28 18:37:02 -04:00
nativeglue.o \
py/pairheap: Add generic implementation of pairing heap data structure.
2020-01-13 01:10:41 -05:00
pairheap.o \
py/ringbuf: Add helpers for put16/get16.
2019-08-27 02:35:02 -04:00
ringbuf.o \
py: Add portable framework to query/check C stack usage. Such mechanism is important to get stable Python functioning, because Python function calling is handled with C stack. The idea is to sprinkle STACK_CHECK() calls in places where there can be C recursion. TODO: Add more STACK_CHECK()'s.
2014-06-24 20:03:34 -04:00
stackctrl.o \
py: Add arg checking helper functions. These are to assist in writing native C functions that take positional and keyword arguments. mp_arg_check_num is for just checking the number of arguments is correct. mp_arg_parse_all is for parsing positional and keyword arguments with default values.
2014-04-19 19:13:22 -04:00
argcheck.o \
py: Add basic framework for issuing compile/runtime warnings.
2015-01-01 02:29:28 -05:00
warning.o \
py: Integrate sys.settrace feature into the VM and runtime. This commit adds support for sys.settrace, allowing to install Python handlers to trace execution of Python code. The interface follows CPython as closely as possible. The feature is disabled by default and can be enabled via MICROPY_PY_SYS_SETTRACE.
2019-08-14 10:09:36 -04:00
profile.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
map.o \
obj.o \
Add skeleton implementation of array.array and bytearray. So far, only storage, initialization, repr() and buffer protocol is implemented - alredy suitable for passing binary data around.
2014-01-18 12:24:47 -05:00
objarray.o \
py: Add attrtuple object, for space-efficient tuples with attr access. If you need the functionality of a namedtuple but will only make 1 or a few instances, then use an attrtuple instead.
2015-04-21 10:14:24 -04:00
objattrtuple.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
objbool.o \
objboundmeth.o \
objcell.o \
objclosure.o \
objcomplex.o \
py/objdeque: Implement ucollections.deque type with fixed size. So far, implements just append() and popleft() methods, required for a normal queue. Constructor doesn't accept an arbitarry sequence to initialize from (am empty deque is always created), so an empty tuple must be passed as such. Only fixed-size deques are supported, so 2nd argument (size) is required. There's also an extension to CPython - if True is passed as 3rd argument, append(), instead of silently overwriting the oldest item on queue overflow, will throw IndexError. This behavior is desired in many cases, where queues should store information reliably, instead of silently losing some items.
2018-02-05 17:06:42 -05:00
objdeque.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
objdict.o \
added enumerate()
2014-01-14 18:55:01 -05:00
objenumerate.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
objexcept.o \
added filter()
2014-01-14 20:37:08 -05:00
objfilter.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
objfloat.o \
objfun.o \
objgenerator.o \
py: Implement iterator support for object that has __getitem__. Addresses Issue #203.
2014-01-24 19:17:36 -05:00
objgetitemiter.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
objint.o \
Add long int implementation using C long long type, enable for unix port.
2014-01-17 13:01:36 -05:00
objint_longlong.o \
Add arbitrary precision integer support. Some functionality is still missing (eg and, or, bit shift), and some things are buggy (eg subtract).
2014-02-22 14:25:23 -05:00
objint_mpz.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
objlist.o \
Added map
2014-01-14 20:10:09 -05:00
objmap.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
objmodule.o \
py: Add 'object' object.
2014-03-22 17:31:28 -04:00
objobject.o \
py/objpolyiter: Implement instance-polymorphic iterator type. This allows to have single itertaor type for various internal iterator types (save rodata space by not having repeating almost-empty type structures). It works by looking "iternext" method stored in particular object instance (should be first object field after "base").
2015-12-14 16:48:12 -05:00
objpolyiter.o \
py: Add property object, with basic functionality. Enabled by MICROPY_ENABLE_PROPERTY.
2014-04-13 13:59:45 -04:00
objproperty.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
objnone.o \
Add basic collections.namedtuple implementation.
2014-02-27 15:22:04 -05:00
objnamedtuple.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
objrange.o \
py: Implement builtin reversed() function. reversed function now implemented, and works for tuple, list, str, bytes and user objects with __len__ and __getitem__. Renamed mp_builtin_len to mp_obj_len to make it publically available (eg for reversed).
2014-08-12 13:33:40 -04:00
objreversed.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
objset.o \
objsingleton: New home for Ellipsis and NotImplemented. Having NotImplemented as MP_OBJ_SENTINEL turned out to be problematic (it needs to be checked for in a lot of places, otherwise it'll crash as would pass MP_OBJ_IS_OBJ()), so made a proper singleton value like Ellipsis, both of them sharing the same type.
2015-05-05 15:18:07 -04:00
objsingleton.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
objslice.o \
objstr.o \
py: Prune unneeded code from objstrunicode, reuse code in objstr.
2014-06-13 15:01:26 -04:00
objstrunicode.o \
modio: Implement io.StringIO class.
2014-04-26 13:26:14 -04:00
objstringio.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
objtuple.o \
objtype.o \
Revamp qstrs: they now include length and hash. Can now have null bytes in strings. Can define ROM qstrs per port using qstrdefsport.h
2014-01-21 16:40:13 -05:00
objzip.o \
py: Factor out impl of special methods for builtin types into opmethods.c
2014-04-13 04:53:15 -04:00
opmethods.o \
sequence.c: Start to refactor sequence operations for reuse among types.
2014-01-20 17:19:19 -05:00
sequence.o \
Add generic implementations of Python read()/write methods for streams. These can be used for any object which implements stream protocol (mp_stream_p_t).
2014-01-07 19:43:48 -05:00
stream.o \
ffi: Implement ffivar.get()/set() methods. Done by introducing another factored out helper API in binary.c. This API can be reused also by array and struct modules.
2014-02-14 10:16:35 -05:00
binary.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
builtinimport.o \
py: Implement builtin exec.
2014-02-03 17:44:10 -05:00
builtinevex.o \
py: Add builtin help function to core, with default help msg. This builtin is configured using MICROPY_PY_BUILTINS_HELP, and is disabled by default.
2017-01-21 07:17:51 -05:00
builtinhelp.o \
Proper support for registering builtin modules in ROM. Comes with some refactoring of code and renaming of files. All modules are now named mod*.[ch].
2014-03-25 10:18:18 -04:00
modarray.o \
py: Allow builtins to be overridden. This patch adds a configuration option (MICROPY_CAN_OVERRIDE_BUILTINS) which, when enabled, allows to override all names within the builtins module. A builtins override dict is created the first time the user assigns to a name in the builtins model, and then that dict is searched first on subsequent lookups. Note that this implementation doesn't allow deleting of names. This patch also does some refactoring of builtins code, creating the modbuiltins.c file. Addresses issue #959.
2014-12-09 11:19:48 -05:00
modbuiltins.o \
Proper support for registering builtin modules in ROM. Comes with some refactoring of code and renaming of files. All modules are now named mod*.[ch].
2014-03-25 10:18:18 -04:00
modcollections.o \
modgc: Add new module for GC-related functionality.
2014-05-05 19:16:43 -04:00
modgc.o \
py: Add "io" module. So far just includes "open" function, which should be supplied by a port. TODO: Make the module #ifdef'ed.
2014-04-03 07:57:53 -04:00
modio.o \
Proper support for registering builtin modules in ROM. Comes with some refactoring of code and renaming of files. All modules are now named mod*.[ch].
2014-03-25 10:18:18 -04:00
modmath.o \
py: Add cmath module, for complex math. Disabled by default. Not all functions implemented. Not enabled on pyboard.
2014-04-17 12:11:03 -04:00
modcmath.o \
Proper support for registering builtin modules in ROM. Comes with some refactoring of code and renaming of files. All modules are now named mod*.[ch].
2014-03-25 10:18:18 -04:00
modmicropython.o \
py: Start implementing "struct" module. Only calcsize() and unpack() functions provided so far, for little-endian byte order. Format strings don't support repition spec (like "2b3i"). Unfortunately, dealing with all the various binary type sizes and alignments will lead to quite a bloated "binary" helper functions - if optimizing for speed. Need to think if using dynamic parametrized algos makes more sense.
2014-04-09 20:45:38 -04:00
modstruct.o \
py, unix: Convert sys module to static representation.
2014-04-12 23:43:18 -04:00
modsys.o \
py: Add uerrno module, with errno constants and dict.
2016-05-10 05:54:25 -04:00
moduerrno.o \
py: Add basic _thread module, with ability to start a new thread.
2016-04-22 18:52:33 -04:00
modthread.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
vm.o \
py: Use variable length encoded uints in more places in bytecode. Code-info size, block name, source name, n_state and n_exc_stack now use variable length encoded uints. This saves 7-9 bytes per bytecode function for most functions.
2014-09-04 09:44:01 -04:00
bc.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
showbc.o \
repl.o \
py: This time, real proper overflow checking of small int power. Previous overflow test was inadequate.
2014-04-04 07:13:51 -04:00
smallint.o \
py: Implement very simple frozen modules support. Only modules (not packages) supported now. Source modules can be converted to frozen module structures using tools/make-frozen.py script.
2015-01-20 04:52:12 -05:00
frozenmod.o \
py/py.mk: Remove .. path component from list of extmod files. This just makes it a bit cleaner in the output of the build process: instead of "CC ../../py/../extmod/" there is now "CC ../../extmod/".
2018-02-21 19:32:31 -05:00
)
py/py.mk: Split list of uPy sources into core and extmod files. If a port only needs the core files then it can now use the $(PY_CORE_O) variable instead of $(PY_O). $(PY_EXTMOD_O) contains the list of extmod files (including some files from lib/). $(PY_O) retains its original definition as the list of all object file (including those for frozen code) and is a convenience variable for ports that want everything.
2018-02-21 19:13:04 -05:00
PY_EXTMOD_O_BASENAME = \
extmod/uasyncio: Add optional implementation of core uasyncio in C. Implements Task and TaskQueue classes in C, using a pairing-heap data structure. Using this reduces RAM use of each Task, and improves overall performance of the uasyncio scheduler.
2020-03-12 01:46:20 -04:00
extmod/moduasyncio.o \
py/py.mk: Remove .. path component from list of extmod files. This just makes it a bit cleaner in the output of the build process: instead of "CC ../../py/../extmod/" there is now "CC ../../extmod/".
2018-02-21 19:32:31 -05:00
extmod/moductypes.o \
extmod/modujson.o \
extmod/modure.o \
extmod/moduzlib.o \
extmod/moduheapq.o \
extmod/modutimeq.o \
extmod/moduhashlib.o \
extmod/moducryptolib: Add ucryptolib module with crypto functions. The API follows guidelines of https://www.python.org/dev/peps/pep-0272/, but is optimized for code size, with the idea that full PEP 0272 compatibility can be added with a simple Python wrapper mode. The naming of the module follows (u)hashlib pattern. At the bare minimum, this module is expected to provide: * AES128, ECB (i.e. "null") mode, encrypt only Implementation in this commit is based on axTLS routines, and implements following: * AES 128 and 256 * ECB and CBC modes * encrypt and decrypt
2018-01-07 08:13:56 -05:00
extmod/moducryptolib.o \
py/py.mk: Remove .. path component from list of extmod files. This just makes it a bit cleaner in the output of the build process: instead of "CC ../../py/../extmod/" there is now "CC ../../extmod/".
2018-02-21 19:32:31 -05:00
extmod/modubinascii.o \
extmod/virtpin.o \
extmod/machine_mem.o \
extmod/machine_pinbase.o \
extmod/machine_signal.o \
extmod/machine_pulse.o \
extmod/machine_i2c.o \
extmod/machine_spi.o \
extmod/modbluetooth: Add low-level Python BLE API.
2019-07-23 10:49:06 -04:00
extmod/modbluetooth.o \
py/py.mk: Remove .. path component from list of extmod files. This just makes it a bit cleaner in the output of the build process: instead of "CC ../../py/../extmod/" there is now "CC ../../extmod/".
2018-02-21 19:32:31 -05:00
extmod/modussl_axtls.o \
extmod/modussl_mbedtls.o \
extmod/modurandom.o \
extmod/moduselect.o \
extmod/moduwebsocket: Refactor `websocket` to `uwebsocket`. As mentioned in #4450, `websocket` was experimental with a single intended user, `webrepl`. Therefore, we'll make this change without a weak link `websocket` -> `uwebsocket`.
2019-02-10 15:35:18 -05:00
extmod/moduwebsocket.o \
py/py.mk: Remove .. path component from list of extmod files. This just makes it a bit cleaner in the output of the build process: instead of "CC ../../py/../extmod/" there is now "CC ../../extmod/".
2018-02-21 19:32:31 -05:00
extmod/modwebrepl.o \
extmod/modframebuf.o \
extmod/vfs.o \
extmod/vfs_blockdev: Factor out block device interface code.
2019-09-08 08:01:09 -04:00
extmod/vfs_blockdev.o \
py/py.mk: Remove .. path component from list of extmod files. This just makes it a bit cleaner in the output of the build process: instead of "CC ../../py/../extmod/" there is now "CC ../../extmod/".
2018-02-21 19:32:31 -05:00
extmod/vfs_reader.o \
extmod: Add VfsPosix filesystem component. This VFS component allows to mount a host POSIX filesystem within the uPy VFS sub-system. All traditional POSIX file access then goes through the VFS, allowing to sandbox a uPy process to a certain sub-dir of the host system, as well as mount other filesystem types alongside the host filesystem.
2018-06-05 23:11:33 -04:00
extmod/vfs_posix.o \
extmod/vfs_posix_file.o \
py/py.mk: Remove .. path component from list of extmod files. This just makes it a bit cleaner in the output of the build process: instead of "CC ../../py/../extmod/" there is now "CC ../../extmod/".
2018-02-21 19:32:31 -05:00
extmod/vfs_fat.o \
extmod/vfs_fat_diskio.o \
extmod/vfs_fat_file.o \
extmod: Add VFS littlefs bindings. Both LFS1 and LFS2 are supported at the same time.
2019-10-18 02:25:08 -04:00
extmod/vfs_lfs.o \
py/py.mk: Remove .. path component from list of extmod files. This just makes it a bit cleaner in the output of the build process: instead of "CC ../../py/../extmod/" there is now "CC ../../extmod/".
2018-02-21 19:32:31 -05:00
extmod/utime_mphal.o \
extmod/uos_dupterm.o \
lib/embed/abort_.o \
lib/utils/printf.o \
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
# prepend the build destination prefix to the py object files
py/py.mk: Remove .. path component from list of extmod files. This just makes it a bit cleaner in the output of the build process: instead of "CC ../../py/../extmod/" there is now "CC ../../extmod/".
2018-02-21 19:32:31 -05:00
PY_CORE_O = $(addprefix $(BUILD)/, $(PY_CORE_O_BASENAME))
PY_EXTMOD_O = $(addprefix $(BUILD)/, $(PY_EXTMOD_O_BASENAME))
py/py.mk: Split list of uPy sources into core and extmod files. If a port only needs the core files then it can now use the $(PY_CORE_O) variable instead of $(PY_O). $(PY_EXTMOD_O) contains the list of extmod files (including some files from lib/). $(PY_O) retains its original definition as the list of all object file (including those for frozen code) and is a convenience variable for ports that want everything.
2018-02-21 19:13:04 -05:00
# this is a convenience variable for ports that want core, extmod and frozen code
PY_O = $(PY_CORE_O) $(PY_EXTMOD_O)
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -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
# object file for frozen code specified via a manifest
ifneq ($(FROZEN_MANIFEST),)
PY_O += $(BUILD)/$(BUILD)/frozen_content.o
endif
py: Move frozen bytecode Makefile rules from ports to common mk files. Now, to use frozen bytecode all a port needs to do is define FROZEN_MPY_DIR to the directory containing the .py files to freeze, and define MICROPY_MODULE_FROZEN_MPY and MICROPY_QSTR_EXTRA_POOL.
2016-11-07 22:28:30 -05:00
# object file for frozen files
py/py.mk: Automatically add frozen.c to source list if FROZEN_DIR is defined. Now frozen modules generation handled fully by py.mk and available for reuse by any port.
2016-10-20 18:08:43 -04:00
ifneq ($(FROZEN_DIR),)
PY_O += $(BUILD)/$(BUILD)/frozen.o
endif
py: Move frozen bytecode Makefile rules from ports to common mk files. Now, to use frozen bytecode all a port needs to do is define FROZEN_MPY_DIR to the directory containing the .py files to freeze, and define MICROPY_MODULE_FROZEN_MPY and MICROPY_QSTR_EXTRA_POOL.
2016-11-07 22:28:30 -05:00
# object file for frozen bytecode (frozen .mpy files)
ifneq ($(FROZEN_MPY_DIR),)
PY_O += $(BUILD)/$(BUILD)/frozen_mpy.o
endif
py: Add rules for automated extraction of qstrs from sources. - add template rule that converts a specified source file into a qstring file - add special rule for generating a central header that contains all extracted/autogenerated strings - defined by QSTR_DEFS_COLLECTED variable. Each platform appends a list of sources that may contain qstrings into a new build variable: SRC_QSTR. Any autogenerated prerequisities are should be appened to SRC_QSTR_AUTO_DEPS variable. - remove most qstrings from py/qstrdefs, keep only qstrings that contain special characters - these cannot be easily detected in the sources without additional annotations - remove most manual qstrdefs, use qstrdef autogen for: py, cc3200, stmhal, teensy, unix, windows, pic16bit: - remove all micropython generic qstrdefs except for the special strings that contain special characters (e.g. /,+,<,> etc.) - remove all port specific qstrdefs except for special strings - append sources for qstr generation in platform makefiles (SRC_QSTR)
2016-03-10 04:22:41 -05:00
# Sources that may contain qstrings
py: Refactor how native emitter code is compiled with a file per arch. Instead of emitnative.c having configuration code for each supported architecture, and then compiling this file multiple times with different macros defined, this patch adds a file per architecture with the necessary code to configure the native emitter. These files then #include the emitnative.c file. This simplifies emitnative.c (which is already very large), and simplifies the build system because emitnative.c no longer needs special handling for compilation and qstr extraction.
2018-04-10 01:06:47 -04:00
SRC_QSTR_IGNORE = py/nlr%
py: Implement a module system for external, user C modules. This system makes it a lot easier to include external libraries as static, native modules in MicroPython. Simply pass USER_C_MODULES (like FROZEN_MPY_DIR) as a make parameter.
2018-06-14 09:57:29 -04:00
SRC_QSTR += $(SRC_MOD) $(filter-out $(SRC_QSTR_IGNORE),$(PY_CORE_O_BASENAME:.o=.c)) $(PY_EXTMOD_O_BASENAME:.o=.c)
py: Add rules for automated extraction of qstrs from sources. - add template rule that converts a specified source file into a qstring file - add special rule for generating a central header that contains all extracted/autogenerated strings - defined by QSTR_DEFS_COLLECTED variable. Each platform appends a list of sources that may contain qstrings into a new build variable: SRC_QSTR. Any autogenerated prerequisities are should be appened to SRC_QSTR_AUTO_DEPS variable. - remove most qstrings from py/qstrdefs, keep only qstrings that contain special characters - these cannot be easily detected in the sources without additional annotations - remove most manual qstrdefs, use qstrdef autogen for: py, cc3200, stmhal, teensy, unix, windows, pic16bit: - remove all micropython generic qstrdefs except for the special strings that contain special characters (e.g. /,+,<,> etc.) - remove all port specific qstrdefs except for special strings - append sources for qstr generation in platform makefiles (SRC_QSTR)
2016-03-10 04:22:41 -05:00
Add the git version to the banner
2014-04-03 19:32:58 -04:00
# Anything that depends on FORCE will be considered out-of-date
FORCE:
.PHONY: FORCE
py: Replace py-version.sh with makeversionhdr.py, written in Python. Also rename py-version.h to mpversion.h for consistency with mpconfig.h.
2015-04-22 12:38:05 -04:00
$(HEADER_BUILD)/mpversion.h: FORCE | $(HEADER_BUILD)
$(Q)$(PYTHON) $(PY_SRC)/makeversionhdr.py $@
Add the git version to the banner
2014-04-03 19:32:58 -04:00
py: Rebuild port if mpconfigport.mk changed (if any). mpconfigport.mk contains configuration options which affect the way MicroPython is linked. In this regard, it's "stronger" configuration dependency than even mpconfigport.h, so if we rebuild everything on mpconfigport.h change, we certianly should of that on mpconfigport.mk change too.
2015-06-10 18:24:54 -04:00
# mpconfigport.mk is optional, but changes to it may drastically change
# overall config, so they need to be caught
MPCONFIGPORT_MK = $(wildcard mpconfigport.mk)
Revamp qstrs: they now include length and hash. Can now have null bytes in strings. Can define ROM qstrs per port using qstrdefsport.h
2014-01-21 16:40:13 -05:00
# qstr data
build: Simplify build directory layout by putting all headers in genhdr. Any generated headers go in $(BUILD)/genhdr/, and are #included as 'genhdr/xxx.h'.
2014-04-17 13:03:27 -04:00
# Adding an order only dependency on $(HEADER_BUILD) causes $(HEADER_BUILD) to get
Rework makefiles. Add proper dependency checking.
2014-01-24 04:05:30 -05:00
# created before we run the script to generate the .h
py: Wrap qstr defs in quotes to protect from C preprocessor. This patch converts Q(abc) to "Q(abc)" to protect the abc from the C preprocessor, then converts back after the preprocessor is finished. So now we can safely put includes in mpconfig(port).h, and also preprocess qstrdefsport.h (latter is now done also in this patch). Addresses issue #1252.
2015-05-30 18:14:34 -04:00
# Note: we need to protect the qstr names from the preprocessor, so we wrap
# the lines in "" and then unwrap after the preprocessor is finished.
docs/develop/qstr.rst: Add documentation for string interning.
2019-09-26 06:25:39 -04:00
# See more information about this process in docs/develop/qstr.rst.
py: Add rules for automated extraction of qstrs from sources. - add template rule that converts a specified source file into a qstring file - add special rule for generating a central header that contains all extracted/autogenerated strings - defined by QSTR_DEFS_COLLECTED variable. Each platform appends a list of sources that may contain qstrings into a new build variable: SRC_QSTR. Any autogenerated prerequisities are should be appened to SRC_QSTR_AUTO_DEPS variable. - remove most qstrings from py/qstrdefs, keep only qstrings that contain special characters - these cannot be easily detected in the sources without additional annotations - remove most manual qstrdefs, use qstrdef autogen for: py, cc3200, stmhal, teensy, unix, windows, pic16bit: - remove all micropython generic qstrdefs except for the special strings that contain special characters (e.g. /,+,<,> etc.) - remove all port specific qstrdefs except for special strings - append sources for qstr generation in platform makefiles (SRC_QSTR)
2016-03-10 04:22:41 -05:00
$(HEADER_BUILD)/qstrdefs.generated.h: $(PY_QSTR_DEFS) $(QSTR_DEFS) $(QSTR_DEFS_COLLECTED) $(PY_SRC)/makeqstrdata.py mpconfigport.h $(MPCONFIGPORT_MK) $(PY_SRC)/mpconfig.h | $(HEADER_BUILD)
py: Wrap qstr defs in quotes to protect from C preprocessor. This patch converts Q(abc) to "Q(abc)" to protect the abc from the C preprocessor, then converts back after the preprocessor is finished. So now we can safely put includes in mpconfig(port).h, and also preprocess qstrdefsport.h (latter is now done also in this patch). Addresses issue #1252.
2015-05-30 18:14:34 -04:00
$(ECHO) "GEN $@"
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
$(Q)$(CAT) $(PY_QSTR_DEFS) $(QSTR_DEFS) $(QSTR_DEFS_COLLECTED) | $(SED) 's/^Q(.*)/"&"/' | $(CPP) $(CFLAGS) - | $(SED) 's/^\"\(Q(.*)\)\"/\1/' > $(HEADER_BUILD)/qstrdefs.preprocessed.h
py: Wrap qstr defs in quotes to protect from C preprocessor. This patch converts Q(abc) to "Q(abc)" to protect the abc from the C preprocessor, then converts back after the preprocessor is finished. So now we can safely put includes in mpconfig(port).h, and also preprocess qstrdefsport.h (latter is now done also in this patch). Addresses issue #1252.
2015-05-30 18:14:34 -04:00
$(Q)$(PYTHON) $(PY_SRC)/makeqstrdata.py $(HEADER_BUILD)/qstrdefs.preprocessed.h > $@
Revamp qstrs: they now include length and hash. Can now have null bytes in strings. Can define ROM qstrs per port using qstrdefsport.h
2014-01-21 16:40:13 -05:00
py: Implement "common word" compression scheme for error messages. The idea here is that there's a moderate amount of ROM used up by exception text. Obviously we try to keep the messages short, and the code can enable terse errors, but it still adds up. Listed below is the total string data size for various ports: bare-arm 2860 minimal 2876 stm32 8926 (PYBV11) cc3200 3751 esp32 5721 This commit implements compression of these strings. It takes advantage of the fact that these strings are all 7-bit ascii and extracts the top 128 frequently used words from the messages and stores them packed (dropping their null-terminator), then uses (0x80 | index) inside strings to refer to these common words. Spaces are automatically added around words, saving more bytes. This happens transparently in the build process, mirroring the steps that are used to generate the QSTR data. The MP_COMPRESSED_ROM_TEXT macro wraps any literal string that should compressed, and it's automatically decompressed in mp_decompress_rom_string. There are many schemes that could be used for the compression, and some are included in py/makecompresseddata.py for reference (space, Huffman, ngram, common word). Results showed that the common-word compression gets better results. This is before counting the increased cost of the Huffman decoder. This might be slightly counter-intuitive, but this data is extremely repetitive at a word-level, and the byte-level entropy coder can't quite exploit that as efficiently. Ideally one would combine both approaches, but for now the common-word approach is the one that is used. For additional comparison, the size of the raw data compressed with gzip and zlib is calculated, as a sort of proxy for a lower entropy bound. With this scheme we come within 15% on stm32, and 30% on bare-arm (i.e. we use x% more bytes than the data compressed with gzip -- not counting the code overhead of a decoder, and how this would be hypothetically implemented). The feature is disabled by default and can be enabled by setting MICROPY_ROM_TEXT_COMPRESSION at the Makefile-level.
2019-09-26 08:19:29 -04:00
$(HEADER_BUILD)/compressed.data.h: $(HEADER_BUILD)/compressed.collected
$(ECHO) "GEN $@"
$(Q)$(PYTHON) $(PY_SRC)/makecompresseddata.py $< > $@
py: Allow registration of modules at their definition. During make, makemoduledefs.py parses the current builds c files for MP_REGISTER_MODULE(module_name, obj_module, enabled_define) These are used to generate a header with the required entries for "mp_rom_map_elem_t mp_builtin_module_table[]" in py/objmodule.c
2019-02-17 22:58:44 -05:00
# build a list of registered modules for py/objmodule.c.
$(HEADER_BUILD)/moduledefs.h: $(SRC_QSTR) $(QSTR_GLOBAL_DEPENDENCIES) | $(HEADER_BUILD)/mpversion.h
@$(ECHO) "GEN $@"
$(Q)$(PYTHON) $(PY_SRC)/makemoduledefs.py --vpath="., $(TOP), $(USER_C_MODULES)" $(SRC_QSTR) > $@
py: Update and rework build system for including external C modules. How to use this feature is documented in docs/develop/cmodules.rst.
2018-12-12 00:50:55 -05:00
SRC_QSTR += $(HEADER_BUILD)/moduledefs.h
py/py.mk: Force nlr files to be compiled with -Os.
2017-03-02 05:56:10 -05:00
# Force nlr code to always be compiled with space-saving optimisation so
# that the function preludes are of a minimal and predictable form.
$(PY_BUILD)/nlr%.o: CFLAGS += -Os
Factor and simplify Makefile's and mpconfig, part 2.
2014-01-07 10:20:33 -05:00
# optimising gc for speed; 5ms down to 4ms on pybv2
Makefile: Allow to override "super optimization" options used for some files. To help with debugging issue like #510 for example.
2014-04-23 19:59:43 -04:00
$(PY_BUILD)/gc.o: CFLAGS += $(CSUPEROPT)
Factor and simplify Makefile's and mpconfig, part 2.
2014-01-07 10:20:33 -05:00
Factor and simplify Makefile's and mpconfig.
2014-01-07 09:54:15 -05:00
# optimising vm for speed, adds only a small amount to code size but makes a huge difference to speed (20% faster)
Makefile: Allow to override "super optimization" options used for some files. To help with debugging issue like #510 for example.
2014-04-23 19:59:43 -04:00
$(PY_BUILD)/vm.o: CFLAGS += $(CSUPEROPT)
py: Add note about -fno-crossjumping when compiling vm.c.
2014-12-28 00:44:09 -05:00
# Optimizing vm.o for modern deeply pipelined CPUs with branch predictors
# may require disabling tail jump optimization. This will make sure that
# each opcode has its own dispatching jump which will improve branch
# branch predictor efficiency.
py/py.mk: Fix broken Gmane URL.
2018-11-30 16:23:53 -05:00
# https://marc.info/?l=lua-l&m=129778596120851
py: Add note about -fno-crossjumping when compiling vm.c.
2014-12-28 00:44:09 -05:00
# http://hg.python.org/cpython/file/b127046831e2/Python/ceval.c#l828
# http://www.emulators.com/docs/nx25_nostradamus.htm
#-fno-crossjumping
extmod: Factor out makefile rules from py.mk to new extmod.mk file. To logically separate extmod related rules out, and prevent py.mk from growing too large.
2019-06-05 00:23:12 -04:00
# Include rules for extmod related code
include $(TOP)/extmod/extmod.mk
Reference in New Issue Copy Permalink