micropython/esp8266
Josef Gajdusek 7e7039b53c esp8266: Export station status() constants 2015-05-03 22:07:00 +03:00
..
Makefile string0.c: Move from stmhal/ to lib/. 2015-04-05 21:57:55 +03:00
README.md esp8266/README: Fix typos. 2014-12-06 13:34:18 +02:00
eagle.rom.addr.v6.ld esp8266: Update ROM address map to vendor SDK 0.9.5. 2015-01-31 00:36:41 +02:00
esp8266.ld esp8266: Move more rodata to irom section. 2014-11-29 14:36:18 +00:00
esp_mphal.c stmhal: Make pybstdio usable by other ports, and use it. 2015-02-13 15:04:53 +00:00
esp_mphal.h stmhal: Make pybstdio usable by other ports, and use it. 2015-02-13 15:04:53 +00:00
etshal.h esp8266: New port of Micro Python to ESP8266 wifi module. 2014-11-27 20:30:33 +00:00
gccollect.c esp8266: Prefix includes with py/; remove need for -I../py. 2015-01-01 21:16:58 +00:00
gccollect.h esp8266: New port of Micro Python to ESP8266 wifi module. 2014-11-27 20:30:33 +00:00
gchelper.s esp8266: New port of Micro Python to ESP8266 wifi module. 2014-11-27 20:30:33 +00:00
main.c py: Protect mp_parse and mp_compile with nlr push/pop block. 2015-02-07 18:33:58 +00:00
makeimg.py esp8266: New port of Micro Python to ESP8266 wifi module. 2014-11-27 20:30:33 +00:00
modesp.c esp8266: Export station status() constants 2015-05-03 22:07:00 +03:00
modpyb.c esp8266: Add basic pyb.Pin class; supports output mode only. 2015-02-13 22:21:44 +00:00
modpyb.h esp8266: Add basic pyb.Pin class; supports output mode only. 2015-02-13 22:21:44 +00:00
modpybpin.c py: Overhaul and simplify printf/pfenv mechanism. 2015-04-16 14:30:16 +00:00
mpconfigport.h py: Overhaul and simplify printf/pfenv mechanism. 2015-04-16 14:30:16 +00:00
qstrdefsport.h esp8266: Export station status() constants 2015-05-03 22:07:00 +03:00
strtoll.c esp8266: Change bignum from mpz to longlong; move some rodata to iram. 2014-11-28 14:58:25 +00:00
uart.c esp8266: Implement task-based, event-driven interface with UART. 2015-01-16 19:20:17 +02:00
uart.h esp8266: New port of Micro Python to ESP8266 wifi module. 2014-11-27 20:30:33 +00:00
uart_register.h esp8266: New port of Micro Python to ESP8266 wifi module. 2014-11-27 20:30:33 +00:00
user_config.h esp8266: New port of Micro Python to ESP8266 wifi module. 2014-11-27 20:30:33 +00:00

README.md

Micro Python port to ESP8266

This is a port of Micro Python to the Espressif ESP8266 wifi module.

Currently implemented features include:

  • REPL (Python prompt) over UART0.
  • 24k heap RAM available for Python code.
  • Garbage collector, exceptions.
  • Unicode support.
  • Builtin modules: gc, array, collections, io, struct, sys.
  • C long-long type used as bignum implementation (gives 64 signed ints).

Note that floating-point numbers are not supported.

On the TODO list:

  • Wifi support.
  • GPIO support.
  • Internal filesystem using the flash.
  • ...

Build instructions

The tool chain required for the build is the OpenSource ESP SDK, which can be found at https://github.com/pfalcon/esp-open-sdk. Clone this repository and run make in its directory to build and install the SDK locally.

Then, to build Micro Python for the ESP8266, just run:

$ make

This should produce binary images in the build/ subdirectory. To flash them to your ESP8266, use:

$ make deploy

This will use the esptool.py script to download the images. You must have your ESP module in the bootloader, and connected to a serial port on your PC. The default serial port is /dev/ttyACM0. To specify another, use, eg:

$ make PORT=/dev/ttyUSB0 deploy

The images that are built are:

  • firmware.elf-0x00000.bin: to be flashed at 0x00000
  • firmware.elf-0x10000.bin: to be flashed at 0x10000

There is also a combined image, made up of the above 2 binary files with the appropriate padding:

  • firmware-combined.bin: to be flashed at 0x00000