2022-06-16 10:40:26 +02:00
# OpenDTU
2022-09-15 19:07:27 +02:00
[](https://github.com/tbnobody/OpenDTU/actions/workflows/build.yml)
[](https://github.com/tbnobody/OpenDTU/actions/workflows/cpplint.yml)
2023-04-05 20:19:31 +02:00
[](https://github.com/tbnobody/OpenDTU/actions/workflows/yarnlint.yml)
2025-07-11 23:58:57 +02:00
[](https://github.com/tbnobody/OpenDTU/actions/workflows/yarnprettier.yml)
2022-09-15 19:07:27 +02:00
2023-03-15 20:39:32 +01:00
## !! IMPORTANT UPGRADE NOTES !!
If you are upgrading from a version before 15.03.2023 you have to upgrade the partition table of the ESP32. Please follow the [this ](docs/UpgradePartition.md ) documentation!
2022-06-16 10:40:26 +02:00
## Background
2023-04-06 23:34:35 +02:00
2022-06-16 10:40:26 +02:00
This project was started from [this ](https://www.mikrocontroller.net/topic/525778 ) 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.
2023-11-15 17:58:43 +01:00
## Documentation
2023-12-31 19:45:54 +01:00
The documentation can be found [here ](https://tbnobody.github.io/OpenDTU-docs/ ).
Please feel free to support and create a PR in [this ](https://github.com/tbnobody/OpenDTU-docs ) repository to make the documentation even better.
2023-11-15 17:58:43 +01:00
2023-12-31 19:45:54 +01:00
## Breaking changes
2022-09-30 18:50:46 +02:00
2023-12-31 19:45:54 +01:00
Generated using: `git log --date=short --pretty=format:"* %h%x09%ad%x09%s" | grep BREAKING`
2023-04-06 23:34:35 +02:00
2023-12-31 19:45:54 +01:00
```code
2025-09-11 20:32:59 +02:00
* 8cab3335 2025-08-07 BREAKING CHANGE: WebAPI endpoint `/api/limit/config` requires different parameters
2025-05-10 13:57:52 +02:00
* 8372deaf 2025-04-18 BREAKING CHANGE: Logging newline changed from "\r\n" to "\n"
2024-02-12 18:27:05 +01:00
* 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
2023-12-31 19:45:54 +01:00
* 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
```
2022-11-19 00:28:16 +01:00
2022-07-01 23:12:35 +02:00
## Currently supported Inverters
2023-04-06 23:34:35 +02:00
2024-09-20 21:36:18 +02:00
A list of all currently supported inverters can be found [here ](https://www.opendtu.solar/hardware/inverter_overview/ )
