Software for ESP32 to talk to Hoymiles/TSUN/Solenso Inverters

balkonkraftwerk esp32 hoymiles mqtt platformio solar solenso tsun

Go to file

Ralf Bauer 970d3cadf8 Merge `88557e49d4` into `3dc70ab40a`		2025-01-11 23:34:51 +00:00
.github	rolled back change	2025-01-12 00:33:47 +01:00
.vscode	Merge branch 'master' of https://github.com/tbnobody/OpenDTU into Database	2024-06-18 21:37:23 +02:00
docs	Merge remote-tracking branch 'origin/Database' into Database	2025-01-10 18:23:52 +01:00
include	Merge remote-tracking branch 'origin/Database' into Database	2025-01-10 18:23:52 +01:00
lang	webapp: show pin mapping categories as cards	2024-11-02 00:28:18 +01:00
lib	Feature: Added device info for HMS-700	2024-10-26 14:51:03 +02:00
pio-scripts	Build factory.bin in every compile attempt	2024-11-07 19:10:41 +01:00
src	Merge remote-tracking branch 'origin/Database' into Database	2025-01-10 18:23:52 +01:00
test	Initial commit	2022-04-09 11:05:14 +02:00
webapp	fixed prettier problems	2025-01-11 02:00:27 +01:00
webapp_dist	fixed build problems of webapp	2025-01-11 01:50:04 +01:00
.editorconfig	Added .editorconfig	2024-01-05 17:26:02 +01:00
.gitignore	Add new log location to .gitignore	2023-05-19 18:21:07 +02:00
COPYING	Updated license file to match right phrase	2022-07-15 19:35:08 +02:00
LICENSE	Change License to GPLv2 as the RF24 lib uses GPL-2.0-only	2022-07-15 18:05:58 +02:00
partitions_custom_4mb.csv	Feature: Added support for boards with 16MB flash and PSRAM	2024-02-02 20:33:42 +01:00
partitions_custom_16mb.csv	Feature: Added support for boards with 16MB flash and PSRAM	2024-02-02 20:33:42 +01:00
platformio_override.ini	Remove set serial port in platformio_override.ini	2023-03-18 12:25:08 +01:00
platformio.ini	Upgrade ESPAsyncWebServer from 3.3.21 to 3.3.22	2024-11-07 18:21:59 +01:00
README.md	Merge remote-tracking branch 'origin/Database' into Database	2025-01-10 18:23:52 +01:00

README.md

OpenDTU-Database-Database

OpenDTU-Database

One year OpenDTU-Database

OpenDTU-Database adds an ESP32 LittleFS Database and two energy charts, a column chart of the last 25 hours and a full calendar chart.

There are 3 new APIs available, returning JSON strings:

API	returned values
/api/database	returns all recored data points from the database with total energy value
/api/databaseHour	returns the energy per hour for the last 25 hours
/api/databaseDay	returns the energy for each day

Each data point has the following format: [ year (00-99), month (1-12), day (1-31), hour (0-23), energy (Wh) ]

Example: [23,6,30,15,132.995605]

The 192KB LittleFS in OpenDTU can store around 6 years of data, because each data point needs only 8 bytes of memory.

Background

This project was started from this discussion (Mikrocontroller.net). It was the goal to replace the original Hoymiles DTU (Telemetry Gateway) with their cloud access. With a lot of reverse engineering the Hoymiles protocol was decrypted and analyzed.

Documentation

The documentation can be found here. Please feel free to support and create a PR in this repository to make the documentation even better.

Breaking changes

Generated using: git log --date=short --pretty=format:"* %h%x09%ad%x09%s" | grep BREAKING

* 1b637f08      2024-01-30      BREAKING CHANGE: Web API Endpoint /api/livedata/status and /api/prometheus/metrics
* e1564780      2024-01-30      BREAKING CHANGE: Web API Endpoint /api/livedata/status and /api/prometheus/metrics
* f0b5542c      2024-01-30      BREAKING CHANGE: Web API Endpoint /api/livedata/status and /api/prometheus/metrics
* c27ecc36      2024-01-29      BREAKING CHANGE: Web API Endpoint /api/livedata/status
* 71d1b3b       2023-11-07      BREAKING CHANGE: Home Assistant Auto Discovery to new naming scheme
* 04f62e0       2023-04-20      BREAKING CHANGE: Web API Endpoint /api/eventlog/status no nested serial object
* 59f43a8       2023-04-17      BREAKING CHANGE: Web API Endpoint /api/devinfo/status requires GET parameter inv=
* 318136d       2023-03-15      BREAKING CHANGE: Updated partition table: Make sure you have a configuration backup and completly reflash the device!
* 3b7aef6       2023-02-13      BREAKING CHANGE: Web API!
* d4c838a       2023-02-06      BREAKING CHANGE: Prometheus API!
* daf847e       2022-11-14      BREAKING CHANGE: Removed deprecated config parsing method
* 69b675b       2022-11-01      BREAKING CHANGE: Structure WebAPI /api/livedata/status changed
* 27ed4e3       2022-10-31      BREAKING: Change power factor from percent value to value between 0 and 1

Currently supported Inverters

A list of all currently supported inverters can be found here