How frankevin25/ecowatt-2026 works
EcoWatt is a residential electricity-monitoring system: firmware measures electrical signals, sends telemetry over MQTT, and a documented backend stores and analyzes it for dashboards and user-facing insights. The repository contains hardware firmware and simulation assets, but the README-described backend, ML pipeline, conversational AI, and dashboard are absent from the tree; those components are shown with null paths and documented relationships only. Firmware excerpts show measurement calls and MQTT publishing; the Arduino-to-ESP32 handoff and downstream product capabilities are documented in the README.
Main entry points: src/main.cpp Arduino sampler · src/main.cpp ESP32 telemetry · MqttService.cpp MQTT service · electricMeasurement.cpp Signal measurement
Components 17
Device firmware
- Arduino sampler
hardware/firmware/arduino/src/main.cpp - Signal measurement
hardware/firmware/arduino/src/electricMeasurement.cpp - ESP32 telemetry
hardware/firmware/esp32/src/main.cpp - MQTT service
hardware/firmware/esp32/src/MqttService.cpp
Telemetry platform
- Django backend
- Time-series store
Energy analytics
- Window preprocessing
- SGN NILM
- Seq2Point backup
- Cost forecast
User experience
- Conversational AI
- Energy dashboard
Other components
- Home electricity
- MQTT broker
- Gemini API
- Claude API
- Resident
Connections 19
- Home electricity → Signal measurement: provides signals
README.md - Arduino sampler → Signal measurement: runs measurement
hardware/firmware/arduino/src/main.cpp - Arduino sampler → ESP32 telemetry: sends TTL serial
README.md - ESP32 telemetry → MQTT service: publishes telemetry
hardware/firmware/esp32/src/main.cpp - MQTT service → MQTT broker: publishes MQTT
hardware/firmware/esp32/src/MqttService.cpp - MQTT broker → Django backend: delivers telemetry
README.md - Django backend → Time-series store: stores readings
README.md - Django backend → Window preprocessing: starts pipeline
README.md - Window preprocessing → SGN NILM: feeds windows
README.md - Window preprocessing → Seq2Point backup: feeds backup
README.md - Django backend → Cost forecast: runs prediction
README.md - SGN NILM → Django backend: returns appliance loads
README.md - Seq2Point backup → Django backend: returns appliance loads
README.md - Django backend → Conversational AI: provides consumption context
README.md - Conversational AI → Gemini API: requests advice
README.md - Conversational AI → Claude API: backup advice
README.md - Django backend → Energy dashboard: serves results
README.md - Energy dashboard → Resident: shows insights
README.md - Resident → Conversational AI: requests recommendations
README.md