Skip to content

rzeldent/esp32-openweather-ttgo

Repository files navigation

ESP32 openweather TTGO

Platform IO CI

openweathermap.org interface for the TTGO-T-Display ESP32 Module

Hardware

No additional hardware is required.

Installation

Create an account at www.openweathermap.org to obtain an API key to query for the weather at your location. I use Visual Studio Code and PlatformIO to edit and upload the sketches. Install these, open the project folder and upload to the esp32-ttgo module using the USB-C connector.

Current state: TTGO Display

Configuration

Make a connection to the access point "OpenWeather". The first time you can connect without a wifi password.

Here, in the menu, update the settings:

  • Open Weather API key. The key obtained from openweather (see above)
  • Location. A name of the location. This should be supported as a location by OpenWeather.
  • TimeZone. The timezone to display the correct (local) time and DST.
  • Use metric units. The choice to use Imperial or Metric settings for the temperature etc...

To reset the configuration press the top button while restarting.

There is also an option to use an alternative weather icon pack. This can be changed by the batch job to generate the icons.

Status

The status is visible when connecting to the device using a web browser. This page shows the status of the device, network and settings.

Status

Current state

At the moment the basic functionality is working:

  • Time is updated, with timezones
  • API is queried and temperature, humidity, pressure, weather description and icons are shown.
  • Web browser configuration and status screen

However, there are still two buttons left on the TTGO-T-Display so room for improvement like:

  • Humidity and temperature icons have some dithering pixels. New images?
  • Provide historical information about temperature / humidity / pressure and graph it.
  • Provide a weather forecast?

Collaboration

New features / pull requests are welcome. Please make a branch and, after checking it might be put into the main branch!

Thanks

Used icons from: https://www.dovora.com/resources/weather-icons/

  • Modern Weather Icon Pack
  • Crystal Weather Icon Pack