ESP8266 and MicroPython

Nick Moore
@mnemote

ESP8266

original image: zeptobars.com

original image: zeptobars.com

Originally came to prominence as a WiFi controller for AVR and similar, but ...

AVR (Arduino)	ESP8266	ARM / Broadcom (RPi 2)
ATMega328P	Tensilica Xtensa LX106	Cortex A53
8 bit	32 bit	32 bit
1 core	1 core	4 core
20 MHz	80-160 MHz	900 MHz
2KB RAM	160KB RAM	1GB RAM
32KB Flash	DIO/QIO Flash	MicroSDHC

original image: adafruit.com

original image: adafruit.com

original image: adafruit.com

Programming the ESP8266

• Serial programming mode to flash memory
  by pulling GPIO0 low at reset
• Any of the usual RS232-TTL converters
• 3.3v at 250mA ...
• ... bad power gives unpredictable results!

The easy way ... NodeMCU

• 3.3v regulator
• USB to serial interface
• Automatic flash &
  reset functions
• Standard 0.1" headers
• $8-$10 on Ebay

Other Boards

esptool

github: themadinventor/esptool

$ git clone https://github.com/themadinventor/esptool
$ cd esptool
$ sudo python setup.py install
$ esptool.py version
$ esptool.py write_flash 0 image.bin

esp-open-sdk — 1

github: pfalcon/esp-open-sdk

• C development using GCC toolchain
• "Free and open (as much as possible)"
• Includes some binary blobs from Espressif

esp-open-sdk — 2

$ git clone --recursive https://github.com/pfalcon/esp-open-sdk
$ sudo apt-get install make unrar autoconf automake \
  libtool gcc g++ gperf flex bison texinfo gawk \
  ncurses-dev libexpat-dev python-dev python python-serial \
  sed git unzip bash help2man wget bzip2 libtool-bin
$ cd esp-open-sdk
$ make

HOW ABOUT A NICE CUP OF TEA?

$ xtensa-lx106-elf/bin/xtensa-lx106-elf-gcc --version
xtensa-lx106-elf-gcc (crosstool-NG
      crosstool-ng-1.22.0-55-gecfc19a) 4.8.5
$ export PATH=`realpath xtensa-lx106-elf/bin/`:$PATH

esp-open-sdk — 3

• support for WiFi and hardware in SDK
• libesphttpd supports HTTP and Websockets
• Not an operating system ...
• ... but interrupt handlers and so on

#include <esp8266.h>
#include "httpd.h"
#include "httpdespfs.h"
#include "espfs.h"
#include "webpages-espfs.h"
#include "../vm/virtual.h"
#include "cgiwebsocket.h"

void myWebsocketConnect(Websock *ws) {
    ws->recvCb = myWebsocketRecv;
    ws->closeCb = myWebsocketClose;
}

HttpdBuiltInUrl builtInUrls[]={
    {"/", cgiRedirect, "/index.html"},
    {"/ws", cgiWebsocket, myWebsocketConnect},
    {"*", cgiEspFsHook, NULL},
    {NULL, NULL, NULL}
};

static os_timer_t vmExecTimer;

void user_init(void) {
    espFsInit((void*)(webpages_espfs_start));
    httpdInit(builtInUrls, 80);

    os_timer_disarm(&vmExecTimer);
    os_timer_setfn(&vmExecTimer, myTimerCallback, NULL);
    os_timer_arm(&vmExecTimer, 20, 1);

    gpio_init();
}

Other Languages

• Lua: Node Lua
• Javascript: Espruino, Cesanta V7 ...
• Forth, Lisp, Basic

... and thanks to a successful Kickstarter campaign and Damien George ...

MicroPython

micropython.org

Download firmware from https://micropython.org/download#esp8266

MicroPython

$ git clone --recursive https://github.com/micropython/micropython.git
$ cd micropython/mpy-cross
$ make
$ cd ../esp8266
$ make axtls
$ make
$ PORT=/dev/ttyUSB0 make deploy

MicroPython REPL

$ cu -l /dev/ttyUSB0 -s 115200
MicroPython v1.8.5-10-g0e69e6b on 2016-10-17; ESP module with ESP8266
Type "help()" for more information.
>>> dir()
['uos', '__name__', 'gc', 'bdev', 'vfs']
>>> print("Hello, World!")
Hello, World!
>>>

MicroPython I/O — 1

>>> import machine
>>> import time
>>> pin2 = machine.Pin(2)
>>> pin2.init(machine.Pin.OUT)
>>> while True:
...     pin2.low()
...     time.sleep(0.5)
...     pin2.high()
...     time.sleep(0.5)

MicroPython I/O — 2

class Servo:
    def __init__(self, pin):
        self.pwm = machine.PWM(machine.Pin(pin))
        self.pwm.freq(50)

    def set(self, pos):
        pulse_us = 1000 + 1000 * min(1,max(pos,0))
        self.pwm.duty(int(pulse_us * self.pwm.freq() * 0.001024))

MicroPython WiFi

>>> import network
>>> sta_if = network.WLAN(network.STA_IF)
>>> sta_if.active(True)
>>> sta_if.scan()
>>> sta_if.connect("my_ap", "my_password")
    

MicroPython Sockets

>>> import socket
>>> sock = socket.socket(socket.AF_INET)
>>> sock.bind(('0.0.0.0', 80))
>>> sock.listen(5)
>>> sock.accept()
(<socket state=2 timeout=-1 incoming=0 off=0>, ('10.107.1.4', 37464))

Python Files

• Frozen in the firmware ...
  • micropython/esp8266/modules/: precompiled and then frozen into the firmware
  • micropython/esp8266/scripts/: frozen into the firmware as python source
• ... or copied in later to the internal VFAT FS
  • WebRepl: copy files through the webrepl interface
  • mpy-utils: copy files through the serial port REPL
    github: nickzoic/mpy-utils

Micropip

$ (cd unix; make axtls; make)
$ unix/micropython -m upip install \
    -p esp8266/modules micropython-functools

github: micropython/micropython-lib

What doesn't MicroPython have?

• An operating system
• Multiprocessing
• Much memory to play with
• Debugger / Profiler

My Projects ...

• Nicer WebREPL
• mDNS
• Flobot

Summary

If you're interested in Microcontrollers / IoT / Robotics:

• ESP8266 is about the cheapest
• MicroPython is about the easiest

Buzzconf!

original image: buzzconf.io

Hands On Workshop ...

Questions / Comments

Nick Moore
Mnemote Pty Ltd

• nick@mnemote.com
• http://mnemote.com/
• @mnemote

Slides:

• http://nick.zoic.org/melbdjango3/

Content and images © Mnemote Pty Ltd except where otherwise noted