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:

This is the beginning of the README. Read the rest at the original. Read the full README ↗