The WeMos D1 mini and its sensor and actuator shields
Introduction
We have seen that the ESP01 can be programmed with micro Python and that there are add-on sensor boards available. However, when we connect the sensor board we lose the serial connection to the PC. This can be corrected by soldering extra connectors to the top of the ESP01 board but this is fiddly and needs good soldering equipment and good soldering skills. The other option is to get access to the ESP01 through WiFi using WebRepl
A better and only slightly more expensive solution (we are talking about ~ 3.5 US$ instead of 2.5 US$) is the Wemos D1 mini board. This board gives us more I/O connections and many more sensor and actuator shields are readily available on the market.
The processor board
ESP8266
The processor board uses an Espressif ESP8266 processor chip and provides 4 MBytes of flash memory.
You will find a description of the pinout at
https://www.teachmemicro.com/getting-started-wemos-d1-mini
For convenience I copied the basic information here.
In contrast to a PC the WeMos D1 mini has only very limited memory resources. While 4 MBytes of flash memory is rather comfortable, the amount of RAM (80 K) is a very limiting factor. When running micropython a mere 30 kBytes is left for your Python programs. There are essentially 2 ways to make most out of the small amount of RAM:
- You can pre-compile your programs to byte code, which takes less space in RAM
- You can code freeze driver libraries, which means you integrate their byte code into The micropython image. This however means, that you must compile your own version of micropython and flash it into the WeMos D1 CPU.
ESP32
As an alternative you have a CPU board based on the more powerful ESP32:
As for the ESP8266 there is a micropython port for the ESP32. The drivers are essentially the same, the pinout of the board however (GPIO numbers for the pins) is different. This means that for every driver we must only change the GPIO number. Since it is possible to find out from micropython on which platform we run (sys.platform tells you if your CPU is an "esp8266" or an "esp32") we can check for the CPU type and adapt the pin numbering as a consequence.
Here is a comparison of the pin assignments for the 2 CPUs:
ESP8266
|
RESET |
RST |
Tx |
GPIO 1 |
|
|
ADC0 |
A0 |
Rx |
GPIO 3 |
|
|
GPIO 16 |
D0 |
D1 |
GPIO 5 |
SCL |
SCK |
GPIO 14 |
D5 |
D2 |
GPIO 4 |
SDA |
MOSI |
GPIO 12 |
D6 |
D3 |
GPIO 0 |
|
MISO |
GPIO 13 |
D7 |
D4 |
GPIO 2 |
|
SS |
GPIO 15 |
D8 |
GND |
GND |
|
|
3.3V |
3V3 |
5V |
5V |
|
ESP32
|
RESET |
RST |
Tx |
|
|
ADC1 channel 0 |
GPIO 36 |
SVP |
Rx |
|
|
|
GPIO 26 |
IO26 |
IO22 |
GPIO 22 |
SCL |
SCK |
GPIO 18 |
IO18 |
IO21 |
GPIO 21 |
SDA |
MOSI |
GPIO 19 |
IO19 |
IO17 |
GPIO 17 |
|
MISO |
GPIO 23 |
IO23 |
IO16 |
GPIO 16 |
|
SS |
GPIO 5 |
IO5 |
GND |
GND |
|
|
3.3V |
3V3 |
5V |
5V |
|
Sensor Shields
A big number of sensor and actuator boards are available. You will find a complete list with their description at
https://docs.wemos.cc/en/latest/d1_mini_shiled/
Here are the sensor shields and their test programs for the workshop:
Here is an overview table showing the devices and their connections:
Module |
Connections |
Functionality |
DHT11 shield |
D4 GPIO 2 |
temperature and humidity sensor |
DS1307 RTC and data logger |
D1: GPIO 5 I2C SCL D2: GPIO 4 I2C SDA D5: GPIO 14 SPI Clock D6: GPIO 12 SPI MOSI D7: GPIO 13 SPI MISO D8: GPIO 15 SPI CS |
Real Time Clock SD card interface |
Buzzer shield |
D5 (default GPIO 14 D6 GPIO 12 D7 GPIO 13 D8 GPIO 15 |
passive buzzer |
1 button shield |
D3: GPIO 0 |
on / off push button |
WS2812B RGB shield |
D2: GPIO 4 |
addressable rgb LED |
LED Matrix shield |
D5 GPIO 14 CLK D7 GPIO 13 Din |
8x8 LED Matrix |
OLED shield |
D1 GPIO 5 I2C SLC D2 GPIO 4 I2C SDA |
64x48 pixel display with SSD1036 I2C controller |
DD18B20 shield |
D2 GPIO 4 |
1-wire digital temperature sensor |
SHT30 shield |
D1 GPIO 5 I2C SCL D2 GPIO 4 I2C SDA |
I2C temperature and humidity sensor |
BMP180 shield |
D1 GPIO 5 I2C SCL D2 GPIO 4 I2C SDA |
I2C barometric pressure sensor and temperature sensor |
For each of the devices I create 2 directories:
- a driver directory containing programs testing the module without Cayenne communication
- a cayenne directory for the final program
You can find the code written for the workshop on github:
https://github.com/uraich/MicroPython_IoTDemos.
There is a second repository also with directories "
drivers" and "
cayenne" containing the same type of programs but written in C++ for the Arduino IDE. The IDE must be set up to work with the ESP8266 and ESP32, which means that the cross-compilers for these machines must be installed.
https://github.com/uraich/C-IoTDemos
Comments