EnergyMe-Home
Available on our website and on Tindie
EnergyMe-Home is an open-source energy monitoring system for home use, capable of monitoring up to 16 circuits. It integrates with any platform through REST API, MQTT, Modbus TCP, and InfluxDB.
Built for makers and DIY enthusiasts who want to track their home's energy consumption. The hardware uses ESP32-S3 and ADE7953 energy measurement IC, while the firmware is written in C++ with PlatformIO and Arduino framework. You can build and customize it yourself - all hardware designs and software are open-source. Prefer it ready to go? Grab a pre-assembled unit.
A demo speaks more than 1000 words: try the demo dashboard!
Join the community! Head over to GitHub Discussions - ask questions, share your builds and dashboards, suggest features, and exchange integration tips. It's the home for everyone building, installing, or tinkering with EnergyMe-Home
Supported Electrical Systems
EnergyMe-Home is compatible with various electrical systems worldwide:
| System Type | Voltage | Configuration | Supported |
|---|
| Single Phase | 230V | L + N | ✅ Europe, Asia, Africa, Oceania |
| Split Phase | 120V/240V | L1 + L2 + N | ✅ North America residential |
| Split Phase | 120V/240V | L1 + L2 (no N) | ✅ Old electrical systems |
| Three Phase | 400V/230V | 3L + N | ❕ Europe commercial/industrial (derived voltages) |
| Three Phase | 208V/120V | 3L + N | ❕ North America commercial (derived voltages) |
Current Transformers Supported:
- 333 mV output CTs (+- 500 mV absolute)
- 3.5 mm jack connectors for easy plug-and-play
Monitoring Capacity:
- Up to 16 circuits simultaneously
- 1× main circuit, sampled at high frequency for accurate total energy measurement
- 15× branch circuits, multiplexed for individual monitoring
⚠️ Important: Installation requires working with your main electrical panel. Always consult a qualified electrician if you're not experienced with electrical installations. The user is responsible for ensuring compliance with local electrical codes and regulations, and assumes all risks associated with the installation and use of this device.
Hardware
The hardware (currently at v6.1) consists of both the PCB design and the components used to build the energy monitoring system.
The key components include:
- ESP32-S3: the brain of the project
- ADE7953: single-phase energy measurement IC
- ZMPT107-1: voltage transformer providing full galvanic isolation between the AC mains and the low-voltage measurement circuitry, with no direct connection between mains and the board's ground
- Multiplexers: used to monitor multiple circuits at once
- 3.5 mm jack connectors: used to easily connect current transformers
PCB schematics and BOMs are available in the hardware/pcb directory, while datasheets for key components are in the hardware/components directory. Additional hardware specifications and technical details can be found in the hardware/README.md, with a condensed one-page summary in the PCB & Firmware Datasheet.
The project is published on EasyEDA for easy access to the PCB design files. You can find the project on EasyEDA OSHWLab.
Software
The firmware is built with C++ using the PlatformIO ecosystem and Arduino 3.x framework, with a task-based architecture using FreeRTOS.
Key Features:
- Energy Monitoring: ADE7953 driver with energy accumulation and CSV logging
- Channel Roles: Load, grid, PV, battery, hybrid inverter and bidirectional channels, with automatic CT reversal detection
- Web Interface: Dashboard for monitoring and system configuration
- Authentication: HTTP Digest with forced default-password change and brute-force lockout
- Integration Options: REST API, MQTT, InfluxDB, and Modbus TCP
- Crash Recovery: Automatic recovery, firmware rollback and core dump archive
- WiFi Setup: Captive portal for configuration and mDNS support (
energyme.local)
- OTA Updates: Firmware updates with MD5 verification and rollback (cloud updates are signature-verified)
- Device Health: Issue registry (CT polarity, over-temperature, ...) and grid blackout detection
- Waveform Analyzer: Capture high-resolution voltage & current waveforms per channel from the web UI
For detailed architecture, implementation details, and API documentation, see source/README.md.
Integration
EnergyMe-Home offers multiple integration options:
以上为 README 的开头部分。其余内容请阅读原文。 查看完整 README ↗
