micropython/ports/unix/mpconfigport.mk

# Enable/disable modules and 3rd-party libs to be included in interpreter

# Build 32-bit binaries on a 64-bit host
MICROPY_FORCE_32BIT = 0

# This variable can take the following values:
#  0 - no readline, just simple stdin input
#  1 - use MicroPython version of readline
MICROPY_USE_READLINE = 1

# btree module using Berkeley DB 1.xx
MICROPY_PY_BTREE = 1

# _thread module using pthreads
MICROPY_PY_THREAD = 1

# Subset of CPython termios module
MICROPY_PY_TERMIOS = 1

# Subset of CPython socket module
MICROPY_PY_SOCKET = 1

# ffi module requires libffi (libffi-dev Debian package)
MICROPY_PY_FFI = 1

# ussl module requires one of the TLS libraries below
MICROPY_PY_USSL = 1
# axTLS has minimal size but implements only a subset of modern TLS
# functionality, so may have problems with some servers.
MICROPY_SSL_AXTLS = 0
# mbedTLS is more up to date and complete implementation, but also
# more bloated.
MICROPY_SSL_MBEDTLS = 1

# jni module requires JVM/JNI
MICROPY_PY_JNI = 0

# Avoid using system libraries, use copies bundled with MicroPython
# as submodules (currently affects only libffi).
MICROPY_STANDALONE = 0
MICROPY_USE_READLINE: Selects link lib, so should be defined in mpconfigport.mk This change allows to build unix version without libreadline installed. 2014-02-27 16:10:40 +00:00			`# Enable/disable modules and 3rd-party libs to be included in interpreter`

New config option MICROPY_FORCE_32BIT (defaulted to 0) Makes it easier for 64-bit unix hosts to build 32-bit unix binaries (for testing) 2014-04-16 01:46:01 +01:00			`# Build 32-bit binaries on a 64-bit host`
			`MICROPY_FORCE_32BIT = 0`

unix: Add option to use uPy readline, and enable by default. This gets uPy readline working with unix port, with tab completion and history. GNU readline is still supported, configure using MICROPY_USE_READLINE variable. 2015-05-24 22:36:31 +01:00			`# This variable can take the following values:`
unix/mpconfigport.mk: Update descriptions of readline and TLS options. 2017-06-17 13:44:28 +01:00			`# 0 - no readline, just simple stdin input`
unix: Add option to use uPy readline, and enable by default. This gets uPy readline working with unix port, with tab completion and history. GNU readline is still supported, configure using MICROPY_USE_READLINE variable. 2015-05-24 22:36:31 +01:00			`# 1 - use MicroPython version of readline`
MICROPY_USE_READLINE: Selects link lib, so should be defined in mpconfigport.mk This change allows to build unix version without libreadline installed. 2014-02-27 16:10:40 +00:00			`MICROPY_USE_READLINE = 1`
Add mpconfigport.mk file to configure which modules to include into build. Proof of concept, controls "ffi" module as one which requires external dependencies. 2014-02-01 18:06:55 +00:00
unix: Enable btree module. But disable it for coverage build, as its extra warninsg aren't compatible with K&R C BerkeleyDB uses. 2016-07-02 13:26:07 +01:00			`# btree module using Berkeley DB 1.xx`
			`MICROPY_PY_BTREE = 1`

unix: Add basic thread support using pthreads. Has the ability to create new threads. 2016-04-22 23:53:51 +01:00			`# _thread module using pthreads`
			`MICROPY_PY_THREAD = 1`

modtermios: Add "termios" unix module, subset of CPython's. Also provides setraw() function from "tty" module (which in CPython is implemented in Python). The idea here is that 95% of "termios" module usage is to set raw mode to allow access to normal serial devices. Then, instead of exporting gazillion termios symbols, it's better to implement it in C, and export minimal number of symbols (mostly baud rates and drain values). 2014-08-19 08:23:14 +01:00			`# Subset of CPython termios module`
			`MICROPY_PY_TERMIOS = 1`

unix: Add target to build "minimal" uPy interpreter. 2015-01-11 17:28:27 +00:00			`# Subset of CPython socket module`
			`MICROPY_PY_SOCKET = 1`

Add mpconfigport.mk file to configure which modules to include into build. Proof of concept, controls "ffi" module as one which requires external dependencies. 2014-02-01 18:06:55 +00:00			`# ffi module requires libffi (libffi-dev Debian package)`
Rename configuration variables controling Python features. Now of the form MICROPY_PY_*. See issue #35. 2014-05-24 23:03:12 +01:00			`MICROPY_PY_FFI = 1`
unix/modjni: "jni" module to interface to JNI-compliant JavaVM. This includes Android Dalvik VM for example. Example usage: import jni System = jni.cls("java/lang/System") System.out.println("Hello, Java!") 2015-09-11 15:57:47 +01:00
unix/mpconfigport.mk: Update descriptions of readline and TLS options. 2017-06-17 13:44:28 +01:00			`# ussl module requires one of the TLS libraries below`
unix: Enable "ussl" module. ussl was in testing mode for 8 months, and now enabled in other ports (e.g. esp8266), so time for unix port to catch up. 2016-05-26 00:12:11 +01:00			`MICROPY_PY_USSL = 1`
unix/mpconfigport.mk: Update comment about TLS implementations. As long as the submodule is checked out, mbedTLS is now fully integrated into the unix build if MICROPY_SSL_MBEDTLS=1. 2019-06-05 06:28:30 +01:00			`# axTLS has minimal size but implements only a subset of modern TLS`
			`# functionality, so may have problems with some servers.`
unix/mpconfigport: Switch ussl from axtls to mbedtls. The reasons to make this switch are: - The axtls library is not being maintained/updated, mbedtls is. - So CI and tests can run against mbedtls, which is now the main TLS library used by the ports (eg stm32, rp2, mimxrt, esp32). Only esp8266 uses axtls. Increases unix standard build on x86-64 by about 89000 bytes. Signed-off-by: Damien George <damien@micropython.org> 2022-07-15 03:27:33 +01:00			`MICROPY_SSL_AXTLS = 0`
unix/mpconfigport.mk: Update descriptions of readline and TLS options. 2017-06-17 13:44:28 +01:00			`# mbedTLS is more up to date and complete implementation, but also`
unix/mpconfigport.mk: Update comment about TLS implementations. As long as the submodule is checked out, mbedTLS is now fully integrated into the unix build if MICROPY_SSL_MBEDTLS=1. 2019-06-05 06:28:30 +01:00			`# more bloated.`
unix/mpconfigport: Switch ussl from axtls to mbedtls. The reasons to make this switch are: - The axtls library is not being maintained/updated, mbedtls is. - So CI and tests can run against mbedtls, which is now the main TLS library used by the ports (eg stm32, rp2, mimxrt, esp32). Only esp8266 uses axtls. Increases unix standard build on x86-64 by about 89000 bytes. Signed-off-by: Damien George <damien@micropython.org> 2022-07-15 03:27:33 +01:00			`MICROPY_SSL_MBEDTLS = 1`
modussl: SSL socket wrapper module based on axTLS. 2015-10-06 16:10:00 +01:00
unix/modjni: "jni" module to interface to JNI-compliant JavaVM. This includes Android Dalvik VM for example. Example usage: import jni System = jni.cls("java/lang/System") System.out.println("Hello, Java!") 2015-09-11 15:57:47 +01:00			`# jni module requires JVM/JNI`
			`MICROPY_PY_JNI = 0`
unix/mpconfigport.mk: Document MICROPY_STANDALONE make-level option. Avoid using system libraries, use copies bundled with MicroPython as submodules (currently affects only libffi, other dependencies either already used as bundled-only (axtls), or can't be bundled (so far), like libjni). 2016-05-28 18:38:14 +01:00
			`# Avoid using system libraries, use copies bundled with MicroPython`
			`# as submodules (currently affects only libffi).`
			`MICROPY_STANDALONE = 0`