Linaro Git Browser
Code Review Sign In
review.linaro.org / lite / micropython / 7d8edeff4e81e89ed8833d9933effd1e2431f7f1 / . / esp8266
tree: d5c32f0341a7629ca11b21d1a235384d0b78cda8 [path history] [tgz]
  1. scripts/
  2. eagle.rom.addr.v6.ld
  3. esp8266.ld
  4. esp_mphal.c
  5. esp_mphal.h
  6. etshal.h
  7. gccollect.c
  8. gccollect.h
  9. gchelper.s
  10. main.c
  11. Makefile
  12. makeimg.py
  13. modesp.c
  14. modpyb.c
  15. modpyb.h
  16. modpybadc.c
  17. modpybpin.c
  18. modpybrtc.c
  19. modpybrtc.h
  20. moduos.c
  21. modutime.c
  22. mpconfigport.h
  23. qstrdefsport.h
  24. README.md
  25. strtoll.c
  26. uart.c
  27. uart.h
  28. uart_register.h
  29. user_config.h
  30. utils.c
  31. utils.h
esp8266/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