61fa7c8152
But now it's generic ring buffer implemented via ringbuf.h, and is intended for any type of input, including dupterm's, not just UART. The general process work like this: an interrupt-driven input source puts data into input_buf, and then signals new data available via call to mp_hal_signal_input(). |
||
|---|---|---|
| .. | ||
| scripts | ||
| tests | ||
| Makefile | ||
| README.md | ||
| eagle.rom.addr.v6.ld | ||
| esp8266.ld | ||
| esp_mphal.c | ||
| esp_mphal.h | ||
| espneopixel.c | ||
| espneopixel.h | ||
| esppwm.c | ||
| esppwm.h | ||
| ets_alt_task.c | ||
| ets_alt_task.h | ||
| etshal.h | ||
| fatfs_port.c | ||
| gccollect.c | ||
| gccollect.h | ||
| gchelper.s | ||
| lexerstr32.c | ||
| main.c | ||
| makeimg.py | ||
| modesp.c | ||
| modmachine.c | ||
| modnetwork.c | ||
| modonewire.c | ||
| modpyb.c | ||
| modpyb.h | ||
| modpybadc.c | ||
| modpybi2c.c | ||
| modpybpin.c | ||
| modpybpwm.c | ||
| modpybrtc.c | ||
| modpybrtc.h | ||
| modpybspi.c | ||
| moduos.c | ||
| modutime.c | ||
| mpconfigport.h | ||
| qstrdefsport.h | ||
| strtoll.c | ||
| uart.c | ||
| uart.h | ||
| uart_register.h | ||
| user_config.h | ||
| utils.c | ||
| utils.h | ||
README.md
MicroPython port to ESP8266
This is a highly experimental port of MicroPython for the WiFi modules based on Espressif ESP8266 chip.
WARNING: The port is highly experimental and any APIs are subject to change.
Currently implemented features include:
- REPL (Python prompt) over UART0.
- Garbage collector, exceptions.
- Unicode support.
- Builtin modules: gc, array, collections, io, struct, sys, esp, network, many more.
- Arbitrary-precision long integers and 30-bit precision floats.
- Basic WiFi support.
- Sockets using modlwip.
- GPIO and bit-banging I2C, SPI support.
- 1-Wire and WS2812 (aka Neopixel) protocols support.
On the TODO list:
- Full wifi 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. Make sure
to add toolchain bin directory to your PATH.
Add the external dependencies to the MicroPython repository checkout:
$ git submodule update --init
See the README in the repository root for more information about external dependencies.
Then, to build MicroPython for the ESP8266, just run:
$ cd esp8266
$ 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 0x00000firmware.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