2015-10-11 23:06:25 +00:00
|
|
|
|
MicroPython port to ESP8266
|
|
|
|
|
===========================
|
2014-11-29 15:06:20 +00:00
|
|
|
|
|
2015-06-19 18:09:53 +00:00
|
|
|
|
This is a highly experimental port of MicroPython for the WiFi modules based
|
2015-06-18 08:46:43 +00:00
|
|
|
|
on Espressif ESP8266 chip.
|
|
|
|
|
|
|
|
|
|
WARNING: The port is highly experimental and any APIs are subject to change.
|
2014-11-29 15:06:20 +00:00
|
|
|
|
|
|
|
|
|
Currently implemented features include:
|
|
|
|
|
- REPL (Python prompt) over UART0.
|
|
|
|
|
- Garbage collector, exceptions.
|
|
|
|
|
- Unicode support.
|
2016-03-27 13:10:58 +00:00
|
|
|
|
- Builtin modules: gc, array, collections, io, struct, sys, esp, network,
|
|
|
|
|
many more.
|
2016-03-23 10:08:15 +00:00
|
|
|
|
- Arbitrary-precision long integers and 30-bit precision floats.
|
2016-04-17 15:17:49 +00:00
|
|
|
|
- WiFi support.
|
2016-03-27 13:10:58 +00:00
|
|
|
|
- Sockets using modlwip.
|
|
|
|
|
- GPIO and bit-banging I2C, SPI support.
|
|
|
|
|
- 1-Wire and WS2812 (aka Neopixel) protocols support.
|
2014-11-29 15:06:20 +00:00
|
|
|
|
- Internal filesystem using the flash.
|
2016-04-30 20:02:54 +00:00
|
|
|
|
- WebREPL over WiFi from a browser (clients at https://github.com/micropython/webrepl).
|
2014-11-29 15:06:20 +00:00
|
|
|
|
|
2016-04-02 21:01:31 +00:00
|
|
|
|
Work-in-progress documentation is available at
|
|
|
|
|
http://docs.micropython.org/en/latest/esp8266/ .
|
|
|
|
|
|
2014-11-29 15:06:20 +00:00
|
|
|
|
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
|
2016-02-08 20:35:24 +00:00
|
|
|
|
run `make` in its directory to build and install the SDK locally. Make sure
|
2016-03-23 10:32:27 +00:00
|
|
|
|
to add toolchain bin directory to your PATH. Read esp-open-sdk's README for
|
|
|
|
|
additional important information on toolchain setup.
|
2014-11-29 15:06:20 +00:00
|
|
|
|
|
2016-03-08 07:22:00 +00:00
|
|
|
|
Add the external dependencies to the MicroPython repository checkout:
|
|
|
|
|
```bash
|
|
|
|
|
$ git submodule update --init
|
|
|
|
|
```
|
|
|
|
|
See the README in the repository root for more information about external
|
|
|
|
|
dependencies.
|
|
|
|
|
|
2015-10-11 23:06:25 +00:00
|
|
|
|
Then, to build MicroPython for the ESP8266, just run:
|
2014-11-29 15:06:20 +00:00
|
|
|
|
```bash
|
2016-03-08 07:22:00 +00:00
|
|
|
|
$ cd esp8266
|
2016-04-28 16:45:36 +00:00
|
|
|
|
$ make axtls
|
2014-11-29 15:06:20 +00:00
|
|
|
|
$ make
|
|
|
|
|
```
|
2016-03-23 10:32:27 +00:00
|
|
|
|
This will produce binary images in the `build/` subdirectory. If you install
|
|
|
|
|
MicroPython to your module for the first time, or after installing any other
|
|
|
|
|
firmware, you should erase flash completely:
|
|
|
|
|
|
|
|
|
|
```
|
2016-04-17 15:16:36 +00:00
|
|
|
|
esptool.py --port /dev/ttyXXX erase_flash
|
2016-03-23 10:32:27 +00:00
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Erase flash also as a troubleshooting measure, if a module doesn't behave as
|
|
|
|
|
expected.
|
|
|
|
|
|
|
|
|
|
To flash MicroPython image to your ESP8266, use:
|
2014-11-29 15:06:20 +00:00
|
|
|
|
```bash
|
|
|
|
|
$ make deploy
|
|
|
|
|
```
|
|
|
|
|
This will use the `esptool.py` script to download the images. You must have
|
2016-03-23 10:32:27 +00:00
|
|
|
|
your ESP module in the bootloader mode, and connected to a serial port on your PC.
|
2014-11-29 15:06:20 +00:00
|
|
|
|
The default serial port is `/dev/ttyACM0`. To specify another, use, eg:
|
|
|
|
|
```bash
|
|
|
|
|
$ make PORT=/dev/ttyUSB0 deploy
|
|
|
|
|
```
|
|
|
|
|
|
2016-03-23 10:32:27 +00:00
|
|
|
|
The image produced is `firmware-combined.bin`, to be flashed at 0x00000.
|
2016-04-06 21:21:04 +00:00
|
|
|
|
|
2016-05-12 09:13:10 +00:00
|
|
|
|
First start
|
|
|
|
|
-----------
|
|
|
|
|
|
|
|
|
|
__Serial prompt__
|
|
|
|
|
|
|
|
|
|
You can access the REPL (Python prompt) over UART (the same as used for
|
|
|
|
|
programming).
|
|
|
|
|
- Baudrate: 115200
|
|
|
|
|
|
|
|
|
|
__WiFi__
|
|
|
|
|
|
|
|
|
|
Initally, the device configures itself as a WiFi access point (AP).
|
|
|
|
|
- ESSID: MicroPython-xxxxxx (x’s are replaced with part of the MAC address).
|
|
|
|
|
- Password: micropythoN (note the upper-case N).
|
|
|
|
|
- IP address of the board: 192.168.4.1.
|
|
|
|
|
- DHCP-server is activated.
|
|
|
|
|
|
|
|
|
|
__WebREPL__
|
|
|
|
|
|
|
|
|
|
Python prompt over WiFi, connecting through a browser.
|
|
|
|
|
- Hosted at http://micropython.org/webrepl.
|
|
|
|
|
- GitHub repository https://github.com/micropython/webrepl.
|
|
|
|
|
|
|
|
|
|
Please follow the instructions there.
|
|
|
|
|
|
|
|
|
|
More detailed instructions can be found at
|
|
|
|
|
http://docs.micropython.org/en/latest/esp8266/esp8266/tutorial/intro.html
|
|
|
|
|
|
2016-04-06 21:21:04 +00:00
|
|
|
|
Troubleshooting
|
|
|
|
|
---------------
|
|
|
|
|
|
|
|
|
|
While the port is still in alpha, it's known to be generally stable. If you
|
|
|
|
|
experience strange bootloops, crashes, lockups, here's a list to check against:
|
|
|
|
|
|
|
|
|
|
- You didn't erase flash before programming MicroPython firmware.
|
|
|
|
|
- Firmware can be occasionally flashed incorrectly. Just retry. Recent
|
|
|
|
|
esptool.py versions have --verify option.
|
|
|
|
|
- Power supply you use doesn't provide enough power for ESP8266 or isn't
|
|
|
|
|
stable enough.
|
|
|
|
|
- A module/flash may be defective (not unheard of for cheap modules).
|
|
|
|
|
|
|
|
|
|
Please consult dedicated ESP8266 forums/resources for hardware-related
|
|
|
|
|
problems.
|