New: Languages available; en,fr,de,es
Arduino based ESP32 standalone device that connects via wifi and reports weather every hour. Provides a rather technical but detailed info for a 48 hour forecast, loaded from https://api.darksky.net/ (must register to get api key). Should remain alive for about 4 months without need to recharge.
Works with;
- 1x Waveshare / Good Display 2.9 (BW), 4.2 (BW or BWR), 5 (BW), 7.5 (BW or BWR) or TTGO T5.
- 1x ESP32 (preferable Lolin32)
- 1x Li-ion 3,7V battery (preferable 4000-5000mAh)
- (Optional) 2x1MOhm resistors for battery voltage measurement
- (Optional) 3D printed frame (https://www.thingiverse.com/thing:3135733)
- (Optional) temp sensor for internal Temp meassure
Although version is fully operative, as code is still really mesy, will be continously improving.
Setup guide at the end of this document.
Lolin32 connections from board to display;
- pin 13 ORANGE - CS
- pin 21 GREEN - DC
- pin 14 WHITE - RST
- pin 22 VIOLET - BUSY
- any +3.3V RED
- any GND BLACK
- pin 35 VOLTAGE (to the middle point of the 1MOhm voltage divider between Bat- and Bat+)
- (optional in GoodDisplay some boards) pin 18 YELLOW - SCK
- (optional in GoodDisplay some boards) pin 23 BLUE - DIN
Customize in hardcode (must edit config.h file with your values)
- darksky api key (can use other sources as OpenWeatherMap but then source should be updated)
- Weather report gps location ( "1.23,4.56" format). You can take the gps coordinates from the url on google maps when pointing at your location.
- in case you need Cloud management, Firebase integration api key should be configured.
- OTA Update requires a AWS S3 account and Firebase integration for remote command.
Also available, cloud Firebase management (requires api key) in order to monitor remotely.
(18/11/11 Update) Added GxEPD driver v1 option as I suspect v2 drivers drain more battery. When using 4,2" screen, driver v1 cycle is 37secs and v2 cycle is 42secs. You can define G1 or G2 to choose version in code.
(18/11/29 Update) Added AWS S3 based OTA upload capabilities. You will need to have a S3 bucket with the bin file uploaded, and then define in the Firebase parameter "OTAUpdate" the name of the bin. The OTA update will be automatically done next time the system reboots.
(18/12/13 Update) Also available Geocoding api to locate the GPS position's Locality name.
(20/03/16 Update) 7 day forecast included as optional.
(20/10/30) Upgraded to FirebaseESP32
You may need to increase partition for apps. On \packages\esp32\hardware\esp32\1.0.4\boards.txt file add:
lolin32.menu.PartitionScheme.med_spiffs=Medium SPIFFS (Large APPS with OTA)
lolin32.menu.PartitionScheme.med_spiffs.build.partitions=med_spiffs
lolin32.menu.PartitionScheme.med_spiffs.upload.maximum_size=1572864
to the file (can change lolin32 with the board of your choice).
and create a med_spiffs.csv file on \packages\esp32\hardware\esp32\1.0.4\tools\partitions with
#Name, Type, Subtype, Offset, Size, Flags
nvs, data, nvs, 0x9000, 0x5000,
otadata, data, ota, 0xe000, 0x2000,
app0, app, ota_0, 0x10000, 0x180000,
app1, app, ota_1, 0x190000,0x180000,
spiffs, data, spiffs, 0x310000,0xF0000,
Front of 4.2" wall version
Back of 4.2" wall version
2.9" desk clock version
- 1 Remaining days of battery expected
- 2 battery graph
- 3 battery historical graph
- 4 Current temp
- 5 Current weather status
- 6 Current Date (you can change language in sketch "WeekDayNames")
- 7 Today's forecast (you can change language in sketch "sWeatherLNG" )
- 8 This week's forecast
- 9 Bold Black graph TEMPERATURE
- 10 Dotted black graph CLOUD %
- 11 Red filled line PRECIPITATION in mm. Probability is detailed in the width of the dotted bars below red line.
- 12 Night, defined by sunset and sunrise lines.
- 13 IP Location or "CustomText" variable in Firebase.
- 14 Time of last update
- 15 Weather icons each 6 hours for a 48 hour forecast.
Customize hardcoded variables at your glance in the first page of .ino file. Choose your hardware there (WS2,WS4c, etc..) and insert your keys (darksy, wifi and so). You can also add those later.
Wifi setup can also be done in the json file "wifi.txt" added in the data folder. Please note that this folder files must be uploaded to the ESP32's SPIFFS with the arduino app.
As binaries are bigger than default ESP32 template, you could need to increase the board partition management. Recommended to add to boards.txt: lolin32.menu.PartitionScheme.med_spiffs=Medium SPIFFS (Large APPS with OTA) lolin32.menu.PartitionScheme.med_spiffs.build.partitions=med_spiffs lolin32.menu.PartitionScheme.med_spiffs.upload.maximum_size=1572864 and select "Medium SPIFFS" in Arduino.
You can later change those values through the Web interface in the Menu operation.
As there no button is needed for normal operation, configuration is done only with reset button. When you push the reset button, you start a boot cycle of all boot modes; "Standard", "Web Server Setup", "Show Values", "ERASE BATT_LEVEL", "ERASE ALL", "OTA DEFAULT". Whenever a boot page is loaded, if you press reset again in the first 3 seconds after the display is refreshed, then you pass to next boot mode.
- Standard: this is the base mode and leads to the weather graph
- Web Server Setup: the device starts a WIFI AP named ESP32 where you can config all functional values
Once you are connected to the ESP32 Wifi AP, open 192.168.4.1 in a browser, and modify the params of choice. You can "Send" the values to the flash config data, or erase all values or return to defaults... Whatever.
- Show values: shows internal operational parameters
- ERASE BATT_LEVEL, deletes all values learned from battery behaviour
- ERASE ALL, deletes all NVS values
- OTA DEFAULT, loads your S3 default bin and writes it down to the OTA partition
Normal operation does not require any button to be pressed and the only display shown is the weather forecast display.