hoylabs / OpenDTU-OnBattery

Software for ESP32 to talk to Hoymiles/TSUN/Solenso Inverters, VE.Direct devices, battery management systems, and related peripherals
GNU General Public License v2.0
301 stars 63 forks source link
balkonkraftwerk esp32 homeassistant-integration hoymiles jkbms mqtt opendtu platformio powermeter pylontech solar solenso tsun vedirect victron

OpenDTU-OnBattery

This is a fork of OpenDTU.

OpenDTU-OnBattery Build cpplint Yarn Linting

What is OpenDTU-OnBattery

OpenDTU-OnBattery is an extension of the original OpenDTU to support battery chargers, battery management systems (BMS) and power meters on a single ESP32. With the help of a Dynamic Power Limiter, the power production can be adjusted to the actual consumption. In this way, it is possible to implement a zero export policy.

Documentation

The canonical documentation of OpenDTU-OnBattery is hosted at https://opendtu-onbattery.net.

You may find additional helpful information in the project's community-maintained Github Wiki.

To find out what's new or improved have a look at the changelog of the releases.

State of the project

OpenDTU-OnBattery is actively maintained. Please note that OpenDTU-OnBattery may change significantly during its development. Bug reports, comments, feature requests and pull requests are welcome!

History of the project

The original OpenDTU project was started from a discussion on Mikrocontroller.net. It was the goal to replace the original Hoymiles DTU (Telemetry Gateway) to avoid using Hoymile's cloud. With a lot of reverse engineering the Hoymiles protocol was decrypted and analyzed.

In the summer of 2022 @helgeerbe bought a Victron MPPT charge cntroller, and didn't like the idea to set up a separate ESP32 to receive the charger's data. He decided to fork OpenDTU and extend it with battery charger support and a Dynamic Power Limiter.

In early October 2024, the project moved to the newly founded GitHub organisation hoylabs and is since maintained by multiple community members.

Acknowledgments