Awesome Open Source
Awesome Open Source

ESP8266 Weather display

This is a simple weather display built with ESP8266 WiFi chip and E ink display. Weather data is gathered from OpenWeatherMap service. Additionally, the device’s internal temperature sensor reading is sent to ThingSpeak service.

Most of the time the device stays in deep sleep mode, consuming only 18 µA. Update operation takes a few seconds, depending on WiFi router, DHCP server and internet connection speed. With 3000 mAh battery and update interval of 15 minutes, the device will last on a single charge for one and a half years.

Building the software

  • Install esp-open-sdk
  • Clone this repository
  • Build and flash the binary
$ git clone
$ cd weatherdisplay/app
$ make all ESP_OPEN_SDK_PATH=/full/path/to/esp-open-sdk
$ make flash ESP_OPEN_SDK_PATH=/full/path/to/esp-open-sdk ESPPORT=/serial/port/devpath

Originally the project was designed with this display, which is now obsolete. In addition to the old display, software currently supports this display from Waveshare. Software is built for this display by default. To build software for the old display, add CFLAGS=-DDISP_MODEL=PERVASIVE to the end of make all command.

Building the hardware

Any ESP8266 based module with at least 1 MB flash and SPI pins, such as ESP-12E, can be used. Development boards, such as NodeMCU-DEVKIT or similar, can be used too, but power consumption of these boards might not be as low.

Displays are connected to ESP8266 in the following way:

ESP8266 Waveshare Pervasive Displays (obsolete)

Notes about Waveshare dispay

DIP switch configuration

DIP switch Position
Display Config B (Other)
Interface Config 1 (3-line SPI)

Power consumption

Waveshare display lacks dedicated enable pin. However, it can be put into sleep mode by executing a command. Ideally, in this mode the display consumes 8 µA. Unfortunately, it has been noticed that the current doesn't always stay at this level. After some time spent in the sleep mode, the current starts to grow and can reach up to 100 µA. The issue was discussed with Waveshare, but they were not able to provide a solution. As a workaround, a high side switch can be used on display's 3V3 line to completely turn off the display. Software uses GPIO5 to control the switch. Software will still execute the sleep command, so the switch can be left out, but power consumption will be higher in this case.

Please see the schematics here.


Device settings can be changed through the serial interface (115200/8-N-1). The following syntax should be used:


At least the following parameters must be set by the user:

Additionally, ThingSpeak channel Write API Key can be set:

  • thingspeak

If this key is not set, internal temperature will not be sent to ThingSpeak (it will still be indicated on the display though).

The following user interface options are available:

Please see the config.c file for additional supported parameters.

Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
C (193,929
Chart (13,545
Weather (11,882
Esp (8,351
Gpio (4,012
Forecast (3,395