lmarzen/esp32-weather-epd
Esp32 Weather Epd
This is an ESP32 firmware project that turns a low-power E-Paper display into a weather dashboard. The device runs on battery power with USB-C recharging, periodically fetches weather forecasts from a remote JSON API, and renders them on the screen alongside indoor sensor readings and battery status.
The project includes a build-time SVG-to-C header converter that embeds weather icons directly into the firmware binary, and those icons can be rotated programmatically to align with wind direction before display. An error state machine handles API failures, low battery, time sync issues, and Wi-Fi disconnection by showing distinct error screens to aid troubleshooting.
Users can personalize the dashboard display by configuring language, units, time and date formats, and air quality scales. The firmware manages Wi-Fi connectivity, NTP time synchronization, battery health monitoring, and charging control for unattended operation.
Features
- E-Paper Display Drivers - Fetches forecast data and indoor sensor readings, then draws them onto a low-power E-Paper screen.
- ADC Voltage Monitors - Reads battery voltage through an ADC to estimate charge level and trigger low-battery warnings.
- E-Paper Weather Displays - Displays weather forecasts and indoor sensor data on a low-power E-Paper screen for at-a-glance viewing.
- JSON Fetching Libraries - Periodically fetches weather forecast data from a remote JSON API and parses it into local data structures.
- SVG-to-Header Converters - Converts SVG weather icons into C header arrays at build time for direct firmware inclusion.
- E-Paper Dashboards - Displays weather data, indoor sensor readings, and battery status on a low-power E-Paper display.
- ESP32 Weather Stations - A low-power ESP32 device that fetches weather forecasts and renders them on an E-Paper screen with customizable settings.
- ESP32 Firmware Projects - Firmware for ESP32 microcontrollers that manages Wi-Fi connectivity, sensor readings, and battery monitoring.
- NTP Time Synchronization - Connects to Wi-Fi and uses NTP to keep the real-time clock accurate for forecast scheduling.
- USB-C Rechargeable Devices - Runs a connected device on battery power with USB-C recharging and battery level monitoring for unattended operation.
- Error State Machines - Switches between distinct display modes for API failures, low battery, time sync issues, and Wi-Fi disconnection.
- E-Paper Frame Buffers - Draws weather data and icons into a memory buffer flushed to the E-Paper display in a single update cycle.
- Battery Monitoring - Monitors battery level and manages USB-C recharging for unattended operation.
- Personal Dashboard Configuration - Customizes language, units, time and date formats, and air quality scales to match personal preferences.
- Wind-Aligned Icon Rotations - Rotates weather icons to point in the same direction as the wind before displaying them.
- Binary-to-C Header Generators - Converts SVG icon files into C header arrays at build time, embedding them directly into the firmware binary.
- SVG-to-Header Converters - Transforms SVG icon files into C header files for direct inclusion in firmware code.
- Error State Screens - Shows distinct error screens for API failures, low battery, time sync issues, and Wi-Fi disconnection.
- USB-C Charge Controllers - Controls the USB-C charging circuit to maintain battery health and prevent overcharging during unattended operation.
- Weather - Customizes weather icons by converting SVG files to firmware-compatible headers and rotating them to align with wind direction.
- Wind Direction Visualizations - Rotates weather icons programmatically based on wind direction data before rendering them to the display buffer.
- Embedded Error Screens - Shows distinct error screens for API failures, low battery, time sync issues, and Wi-Fi disconnection.
Star history
How this analysis was created: This summary and feature list are AI-generated from collected project material and can contain mistakes. Stars, license and language are imported from GitHub. Inclusion does not mean that we have tested or audited this project. Check the source documentation for any feature you depend on. Learn more on our About page.
