2017-05-01 05:39:39 -04:00
|
|
|
This is the experimental, community-supported Windows port of MicroPython.
|
2014-04-20 15:35:11 -04:00
|
|
|
It is based on Unix port, and expected to remain so.
|
2014-05-05 06:18:27 -04:00
|
|
|
The port requires additional testing, debugging, and patches. Please
|
|
|
|
consider to contribute.
|
|
|
|
|
2014-04-20 15:35:11 -04:00
|
|
|
|
2017-04-29 17:37:05 -04:00
|
|
|
Building on Debian/Ubuntu Linux system
|
|
|
|
---------------------------------------
|
2014-04-20 15:35:11 -04:00
|
|
|
|
2017-04-29 17:37:05 -04:00
|
|
|
sudo apt-get install gcc-mingw-w64
|
|
|
|
make CROSS_COMPILE=i686-w64-mingw32-
|
2015-10-31 18:02:10 -04:00
|
|
|
|
2015-11-01 12:20:39 -05:00
|
|
|
If for some reason the mingw-w64 crosscompiler is not available, you can try
|
|
|
|
mingw32 instead, but it comes with a really old gcc which may produce some
|
2015-10-31 18:02:10 -04:00
|
|
|
spurious errors (you may need to disable -Werror):
|
|
|
|
|
2017-04-29 17:37:05 -04:00
|
|
|
sudo apt-get install mingw32 mingw32-binutils mingw32-runtime
|
|
|
|
make CROSS_COMPILE=i586-mingw32msvc-
|
2014-04-20 15:35:11 -04:00
|
|
|
|
2014-05-05 06:18:27 -04:00
|
|
|
|
2017-05-01 05:39:39 -04:00
|
|
|
Building under Cygwin
|
|
|
|
---------------------
|
2014-05-05 06:18:27 -04:00
|
|
|
|
2015-11-01 12:20:39 -05:00
|
|
|
Install following packages using cygwin's setup.exe:
|
|
|
|
|
2017-04-29 17:37:05 -04:00
|
|
|
* mingw64-i686-gcc-core
|
|
|
|
* mingw64-x86_64-gcc-core
|
|
|
|
* make
|
|
|
|
|
|
|
|
Build using:
|
2014-05-05 06:18:27 -04:00
|
|
|
|
2017-04-29 17:37:05 -04:00
|
|
|
make CROSS_COMPILE=i686-w64-mingw32-
|
2015-11-20 09:59:06 -05:00
|
|
|
|
2017-04-29 17:37:05 -04:00
|
|
|
Or for 64bit:
|
2015-11-20 09:59:06 -05:00
|
|
|
|
2017-04-29 17:37:05 -04:00
|
|
|
make CROSS_COMPILE=x86_64-w64-mingw32-
|
2014-05-05 06:18:27 -04:00
|
|
|
|
|
|
|
|
2017-04-29 17:37:05 -04:00
|
|
|
Building using MS Visual Studio 2013 (or higher)
|
|
|
|
------------------------------------------------
|
2014-05-05 06:18:27 -04:00
|
|
|
|
2017-05-01 05:39:39 -04:00
|
|
|
In the IDE, open `micropython.vcxproj` and build.
|
2014-05-05 06:18:27 -04:00
|
|
|
|
2017-05-01 05:39:39 -04:00
|
|
|
To build from the command line:
|
2014-05-05 06:18:27 -04:00
|
|
|
|
2017-04-29 17:37:05 -04:00
|
|
|
msbuild micropython.vcxproj
|
2015-06-04 12:29:51 -04:00
|
|
|
|
2017-05-01 05:59:39 -04:00
|
|
|
__Stack usage__
|
|
|
|
|
|
|
|
The msvc compiler is quite stack-hungry which might result in a "maximum recursion depth exceeded"
|
|
|
|
RuntimeError for code with lots of nested function calls.
|
|
|
|
There are several ways to deal with this:
|
2017-09-06 00:09:13 -04:00
|
|
|
- increase the threshold used for detection by altering the argument to `mp_stack_set_limit` in `ports/unix/main.c`
|
|
|
|
- disable detection all together by setting `MICROPY_STACK_CHECK` to "0" in `ports/windows/mpconfigport.h`
|
2017-05-01 05:59:39 -04:00
|
|
|
- disable the /GL compiler flag by setting `WholeProgramOptimization` to "false"
|
|
|
|
|
|
|
|
See [issue 2927](https://github.com/micropython/micropython/issues/2927) for more information.
|
|
|
|
|
2015-06-04 12:29:51 -04:00
|
|
|
|
2017-04-29 17:37:05 -04:00
|
|
|
Running on Linux using Wine
|
|
|
|
---------------------------
|
2015-06-04 12:29:51 -04:00
|
|
|
|
2015-11-01 12:20:39 -05:00
|
|
|
The default build (MICROPY_USE_READLINE=1) uses extended Windows console
|
2017-05-01 05:39:39 -04:00
|
|
|
functions and thus should be ran using the `wineconsole` tool. Depending
|
2015-11-01 12:20:39 -05:00
|
|
|
on the Wine build configuration, you may also want to select the curses
|
|
|
|
backend which has the look&feel of a standard Unix console:
|
2015-06-04 12:29:51 -04:00
|
|
|
|
|
|
|
wineconsole --backend=curses ./micropython.exe
|
|
|
|
|
2017-04-29 17:37:05 -04:00
|
|
|
For more info, see https://www.winehq.org/docs/wineusr-guide/cui-programs .
|
2015-06-04 12:29:51 -04:00
|
|
|
|
|
|
|
If built without line editing and history capabilities
|
2016-07-22 14:24:26 -04:00
|
|
|
(MICROPY_USE_READLINE=0), the resulting binary can be run using the standard
|
2017-04-29 17:37:05 -04:00
|
|
|
`wine` tool.
|