The tiny Home Assistant energy display.
Helios Mini is a compact, standalone circular display that shows your Home Assistant Energy Dashboard in real time — solar production, home consumption, battery flow, and grid import/export — with no phone, tablet, or wall-mounted tablet required.
Connect it, configure it once, and it works.
It's the little sibling of Helios, the 2.5D solar card for Home Assistant, and pairs with Helios-Forecast for solar production forecasting.
V0.1 — Hardware Bring-Up, running on real hardware. Firmware for
display, touch, Wi-Fi, and buttons is written in
firmware/, ported from Waveshare's own reference firmware for
this exact board, plus the Wi-Fi setup slice of V0.2 (SoftAP + browser
setup page, spec Section 16) ahead of schedule. Flashed and verified on the
actual board: boots, serves its own HELIOS-MINI-XXXX Wi-Fi setup network,
and connects to a home network end-to-end from a phone with no app or
dev tools — once connected, the device shows its own IP permanently on
screen, reachable from a browser for Home Assistant settings (a URL + a
Long-Lived Access Token instead of the discovery/pairing flow originally
sketched in the spec). See firmware/README.md for
flash/monitor instructions, docs/SPEC.md for the full
product specification, and docs/HARDWARE_REFERENCE.md
for the verified pin mapping and hardware bring-up notes.
- Base board: Waveshare ESP32-S3-Touch-AMOLED-1.32 (ESP32-S3, 466×466 circular AMOLED, CST820 touch)
- Power: USB-C only, no battery in the commercial configuration
- Enclosure: custom 3D-printed ASA, open-sourced as STL/STEP
Helios-Mini/
├── firmware/ ESP-IDF firmware (display, touch, Wi-Fi, HA client, OTA, UI)
├── home-assistant/ Home Assistant integration for discovery/pairing
├── hardware/ Mechanical reference of the Waveshare board, connectors, dimensions
├── enclosure/ 3D-printable enclosure
│ ├── stl/ Ready-to-print STL files
│ ├── step/ STEP files for CAD editing
│ └── source/ Parametric source (OpenSCAD)
├── installer/ Browser-based firmware installer (WebSerial/ESP Web Tools)
├── assets/ Branding, renders, product images
├── docs/ Specification and technical documentation
├── tools/ Dev/build/flash helper scripts
└── CHANGELOG.md
Open-source firmware, hardware documentation, and enclosure STL/STEP files, licensed under GPL-3.0.
- Helios — the original 2.5D Home Assistant solar card
- Helios-Forecast — self-learning solar production forecast integration