README.md
View this project on CADLAB.io.

WiFiWeatherGuy

WeatherGuy for ESP8266.



Hardware


Wemos D1 Mini
ILI9163-based TFT display, see ]]>here]]>


Software


Arduino 1.8.9
]]>TFT_eSPI library]]> 2.4.44
]]>ESP8266 for Arduino]]> 3.0.2
]]>Arduino ESP8266 filesystem uploader]]>
]]>ArduinoJson]]> 6.19.3
]]>Timezone]]> 1.2.4
]]>Time]]> 1.6
]]>SimpleTimer]]>


Installation


Get an API key for your Provider (the default is OpenWeatherMap)
Edit data/config.json with your preferences
Configure your display in TFT_eSPI/User_Setup.h (if using the Arduino IDE), otherwise edit Makefile
Configure your timezone in zone.h
Upload the filesystem (Tools > ESP8266 Sketch Data Upload)
Upload the sketch


Note

The weather icons must be 24-bit bitmaps; convert from GIF as follows:

% convert foo.gif -type truecolor foo.bmp 


Providers

Original support was only for Wunderground. However changes to its
terms of service means it is no longer supported. (Wunderground
client code remains for reference.)

Open Weather Map

The current supported provider is ]]>OpenWeatherMap]]>.
Limitations of this API are:
- astronomy: moon age, phase
- forecasts: forecasts in the free API are every 3 hours and you get 40 of
them, which is too big to parse on an ESP8266. (Currently we hack this by
getting 16 of them and skipping every other one.)

Dark Sky

Limitations of the ]]>Dark Sky API]]> are:
- no icons (but can use other iconsets)
- lat/lon only (no "by city")
- moon phase only (no moonrise/set)
- aka forecast.io

Credits


Javascript ]]>transparency]]>