You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Lauri Võsandi 7ef2d2ecfb Fixes 5 years ago
bin Added preliminary files 5 years ago
.gitignore Initial commit 5 years ago
LICENSE Initial commit 5 years ago
Makefile Added sonar example, fixed URL-s 5 years ago Fixes 5 years ago Fixes 5 years ago Added preliminary files 5 years ago Added preliminary files 5 years ago Added preliminary files 5 years ago

Hello MicroPython

Getting started

This howto assumes Ubuntu 16.04 is used on the computer and several tools have been installed:

sudo apt install picocom make python3-pip
sudo pip3 install esptool adafruit-ampy

Clone the Git repository and run makefiles:

git clone
cd micropython-skeleton

Blinking LED-s

First let's some LED-s blinking. Press Ctrl-E for paste mode, otherwise spaces get mangled. Press Ctrl-Shift-V for pasting. Press Ctrl-D to exit paste mode and evaluate the code.

from time import sleep
from machine import Pin

# RGB LED is connected to programmable pins 12, 13, 15
led_red = Pin(12, Pin.OUT)
led_green = Pin(13, Pin.OUT)
led_blue = Pin(15, Pin.OUT)

# The values are inverted because 3.3v is common pin

for j in range(0, 5):


  1. Modify the code so yellow, cyan, magenda and white would be included.

Button presses

On the board there is button labelled "Boot", this is hooked up to pin 2. By default there is a resistor which pulls the voltage on the pin to 3.3v, but when button is pressed the pin is shorted to ground so the voltage goes to 0v. Most modern solutions use interrupts to detect voltage change on the pin:

from machine import Pin
from time import sleep

Pin(12, Pin.OUT).value(1)
Pin(13, Pin.OUT).value(1)
led_blue = Pin(15, Pin.OUT)
button = Pin(0)

turned_off = False

def callback(p):
    global turned_off
    turned_off = not turned_off

# Execute function 'callback' when voltage goes from 3.3v to 0v on pin 0
button.irq(trigger=Pin.IRQ_FALLING, handler=callback)


  1. Modify the code so pressing button shuffles between off, red, green, blue, yellow, cyan, magenta and white

Driving OLED screens

Let's get some pixels on the screen. There's 128x64 pixels monochrome OLED screen connected via I2C bus on the pins 4 and 5.

from machine import Pin, I2C
from ssd1306 import SSD1306_I2C

i2c = I2C(-1, Pin(4),Pin(5), freq=400000) # Bitbanged I2C bus
oled = SSD1306_I2C(128, 64, i2c)
oled.invert(0) # White text on black background
oled.contrast(255) # Maximum contrast

name = "Lauri"
oled.text("Hi %s" % name, 10, 10)


  1. When button is pressed show a corresponding message on the screen - lights turned on/off or the name of the color shown

Temperature & humidity

Next let's hook up DHT11 sensor to the board and measure the temperature.

  • Sensor's Vcc is connected to 3.3v on the board
  • Ground pins (GND) are connected
  • Sensor's data pin is connected to board pin 4

Some code to get you going:

from time import sleep
from machine import Pin
from dht import DHT11

d = DHT11(Pin(4))

except OSError:
    print("Sensor not connected")
    print("Temperature %sC" % d.temperature())
    print("Humidity %s%%" % d.humidity())


  1. Get temperature and humidity displayed on the screen

Distance with sonar

In this case HC-SR04 is hooked up:

  • Trigger is connected to pin 25
  • Echo is connected to pin 26
  • GND pins are connected
  • Sonar's Vcc is connected to 3.3V on the board

Code to measure distance:

from time import sleep_us, sleep_ms
from machine import Pin, time_pulse_us

trigger = Pin(25, Pin.OUT)
echo = Pin(26, Pin.IN)

def measure():

    duration = time_pulse_us(echo, 1, 29000)
    distance = (duration / 2.0) / 29
    return distance

while True:
    print("Distance is: %s cm" % measure())


  1. Get distance shown on OLED display

Connecting to internet

Exit the serial console by pressing Ctrl-A and then Ctrl-Q. Upload module to handle WebSockets and return to Python prompt:

ampy -p /dev/ttyUSB0 put
ampy -p /dev/ttyUSB0 put # Script that connects to itcollege network
make console

Press EN button on the board to reset the board.

Paste following:

import sys
import uwebsockets
from machine import Pin

Pin(12, Pin.OUT).value(1)
Pin(13, Pin.OUT).value(1)
led_blue = Pin(15, Pin.OUT)

channel = "living-room-of-lauri"
uri = "ws://" + channel
print("Connecting to:", uri)
conn = uwebsockets.connect(uri)

turned_off = False

while True:
    print("Reading message...")
    fin, opcode, data = conn.read_frame()
    if data == "toggle":
        turned_off = not turned_off
        print("Got unknown command:", data)

Using web browser navigate here

  1. Move to another channel to prevent flipping lights in my living room
  2. Improve the code so the "Boot" button and button in the web interface both work simultaneously
  3. Download the HTML file and add buttons to select different colors, adjust Python code to handle new commands
  4. Add code to send sensor readings to the webserver


ESP32 microcontroller with MicroPython is a really cheap way to get started with the IoT stuff. See more detailed information here.

Some more tricks to try:

Other interesting projects with ESP8266 and ESP32 microcontrollers:

Come and visit on Wednesdays 18:00 for more of MicroPython