OpenDTU
An alternative open source software for communicating with Hoymiles solar inverters, which synchronises everything with the s-Miles cloud.
https://github.com/tbnobody/opendtu
Category: Renewable Energy
Sub Category: Photovoltaics and Solar Energy
Keywords
balkonkraftwerk esp32 hoymiles mqtt platformio solar solenso tsun
Keywords from Contributors
pv asyncwebserver cmt2300 nrf24 varta varta-storage opendtu hacs ahoy solar-energy
Last synced: about 22 hours ago
JSON representation
Repository metadata
Software for ESP32 to talk to Hoymiles/TSUN/Solenso Inverters
- Host: GitHub
- URL: https://github.com/tbnobody/opendtu
- Owner: tbnobody
- License: gpl-2.0
- Created: 2022-06-24T11:26:42.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2026-11-11T16:06:28.000Z (5 days ago)
- Last Synced: 2026-11-15T12:12:02.979Z (about 21 hours ago)
- Topics: balkonkraftwerk, esp32, hoymiles, mqtt, platformio, solar, solenso, tsun
- Language: C++
- Homepage:
- Size: 65.2 MB
- Stars: 2,209
- Watchers: 49
- Forks: 647
- Open Issues: 184
- Releases: 83
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: COPYING
README.md
OpenDTU
!!! 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 documentation!
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
* 8cab3335 2025-08-07 BREAKING CHANGE: WebAPI endpoint `/api/limit/config` requires different parameters
* 8372deaf 2025-04-18 BREAKING CHANGE: Logging newline changed from "\r\n" to "\n"
* 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 in the supported inverter overview.
LLM/AI Development Policy
LLM output is expressly prohibited for any direct communication, including the following:
- issues or comments
- feature requests or comments
- pull request bodies or comments
- forum/chat/etc. posts or comments
In short, if you are posting any of those things, the output must be your own words, explanation, description, etc., not a verbatim dump of an LLM's output. We expect you to understand what you're posting. Violating this rule will result in closure/deletion of the offending item(s).
An exception will be made for LLM-assisted translations if you are having trouble accurately conveying your intent in English. Please explicitly note this ("I have translated this from MyLanguage with an LLM") and, if possible, post in your original language as well.
Owner metadata
- Name:
- Login: tbnobody
- Email:
- Kind: user
- Description:
- Website:
- Location: Germany
- Twitter:
- Company:
- Icon url: https://avatars.githubusercontent.com/u/1753222?u=90d970a618fd5f1020a7da8e71768be4d646e08a&v=4
- Repositories: 34
- Last ynced at: 2026-11-08T08:33:50.393Z
- Profile URL: https://github.com/tbnobody
GitHub Events
Total
- Commit comment event: 8
- Create event: 222
- Delete event: 242
- Discussion event: 10
- Fork event: 43
- Gollum event: 28
- Issue comment event: 1721
- Issues event: 232
- Pull request event: 393
- Pull request review comment event: 9
- Pull request review event: 8
- Push event: 12
- Release event: 9
- Watch event: 258
Last Year
- Create event: 65
- Delete event: 60
- Discussion event: 9
- Fork event: 5
- Gollum event: 1
- Issue comment event: 109
- Issues event: 13
- Pull request event: 51
- Pull request review event: 1
- Push event: 2
- Watch event: 24
Committers metadata
Last synced: 2 days ago
Total Commits: 2,203
Total Committers: 83
Avg Commits per committer: 26.542
Development Distribution Score (DDS): 0.14
Commits in past year: 118
Committers in past year: 16
Avg Commits per committer in past year: 7.375
Development Distribution Score (DDS) in past year: 0.373
| Name | Commits | |
|---|---|---|
| Thomas Basler | t****s@f****t | 1895 |
| Bernhard Kirchen | s****n@p****t | 75 |
| Mathieu Carbou | m****u@g****m | 22 |
| Martin Dummer | m****r@g****t | 20 |
| LennartF22 | 1****2 | 18 |
| dependabot[bot] | 4****] | 13 |
| Axel Hinrichs | h****s@b****e | 12 |
| Markus Krause | K****s@g****m | 10 |
| Stefan Oberhumer | s****n@o****m | 10 |
| Nikolaj Kappler | i****o@n****e | 8 |
| Marc-Philip | m****6@g****e | 7 |
| Fabian Hassel | v****n@d****e | 4 |
| fischaxe | a****l@m****e | 4 |
| SW-Nico | s****t@w****e | 4 |
| Stefan Schultheis, OE1SCS | s****i | 3 |
| Steffen Moeller | m****r@d****g | 3 |
| Timo Schindler | t****o@b****e | 3 |
| jstammi | j****i@g****t | 3 |
| xX-nichtlachen-Xx | n****n@y****e | 3 |
| Andreas Böhm | a****s@b****x | 3 |
| Tobias Diedrich | r****t@t****e | 3 |
| stefan123t | s****t | 3 |
| 0lini | 7****i | 3 |
| Luca Kröger | l****r@p****e | 3 |
| Michael Wilk | m****k@m****h | 3 |
| ryan5836600 | 1****0 | 2 |
| mbo18 | m****8 | 2 |
| helgeerbe | h****e@e****e | 2 |
| Sabouflage | s****e | 2 |
| Pierre Kancir | p****n@g****m | 2 |
| and 53 more... | ||
Committer domains:
- gmx.net: 3
- gmx.de: 3
- dlhnet.de: 1
- erbehome.de: 1
- mrsoft.gmbh: 1
- pexon-consulting.de: 1
- tdiedrich.de: 1
- boehm.cx: 1
- yahoo.de: 1
- bluit.de: 1
- debian.org: 1
- mnet-online.de: 1
- devshm.de: 1
- nkappler.de: 1
- obssys.com: 1
- gmx.com: 1
- bitscape.de: 1
- posteo.net: 1
- codechaos.org: 1
- weickelt.de: 1
- pieterhollander.nl: 1
- mailbox.org: 1
- lerch-familie.de: 1
- spam.dobel.click: 1
- stangl.st: 1
- i-matrixx.de: 1
- moesch.org: 1
- nikwest.de: 1
- outlook.de: 1
- roth-itk.de: 1
- jlsnet.info: 1
- diefreunds.de: 1
- fobg.de: 1
- ssssss.com: 1
- dumont.de: 1
- fit.fraunhofer.de: 1
- familie-basler.net: 1
Issue and Pull Request metadata
Last synced: 2 days ago
Total issues: 883
Total pull requests: 1,578
Average time to close issues: 2 months
Average time to close pull requests: 16 days
Total issue authors: 633
Total pull request authors: 146
Average comments per issue: 7.89
Average comments per pull request: 2.26
Merged pull request: 171
Bot issues: 5
Bot pull requests: 1,153
Past year issues: 58
Past year pull requests: 310
Past year average time to close issues: 2 months
Past year average time to close pull requests: 9 days
Past year issue authors: 55
Past year pull request authors: 22
Past year average comments per issue: 7.03
Past year average comments per pull request: 3.05
Past year merged pull request: 33
Past year bot issues: 0
Past year bot pull requests: 238
Top Issue Authors
- Juergen2453 (8)
- grasmax (8)
- broth-itk (8)
- helgeerbe (8)
- DejanBukovec (7)
- tbnobody (7)
- Elektron79 (6)
- itn3rd77 (6)
- schlimmchen (6)
- D3R-ST3FAN (5)
- njordan77 (5)
- juergen-weber (5)
- wib100 (5)
- stefan123t (5)
- m-froehlich (5)
Top Pull Request Authors
- dependabot[bot] (1,152)
- schlimmchen (43)
- mathieucarbou (34)
- madmartin (19)
- StefanOberhumer (14)
- LennartF22 (11)
- stefan123t (11)
- smoe (10)
- xX-nichtlachen-Xx (10)
- dAjaY85 (10)
- ahinrichs (10)
- nkappler (7)
- ranma (7)
- mpw96 (6)
- HacksBugsAndRockAndRoll (6)
Top Issue Labels
- bug (481)
- enhancement (298)
- stale (95)
- question (8)
- javascript (5)
- contribution needed (5)
- dependencies (5)
- acknowledged (3)
Top Pull Request Labels
- dependencies (1,152)
- javascript (1,112)
- github_actions (40)
- S-stale (1)
Dependencies
- actions/cache v3 composite
- actions/checkout v4 composite
- actions/download-artifact v3 composite
- actions/setup-node v4 composite
- actions/setup-python v4 composite
- actions/upload-artifact v3 composite
- mikepenz/release-changelog-builder-action v3 composite
- softprops/action-gh-release v1 composite
- actions/checkout v3 composite
- actions/setup-python v4 composite
- actions/checkout v3 composite
- actions/setup-node v3 composite
- @intlify/unplugin-vue-i18n ^1.5.0 development
- @rushstack/eslint-patch ^1.5.1 development
- @tsconfig/node18 ^18.2.2 development
- @types/bootstrap ^5.2.9 development
- @types/node ^20.9.0 development
- @types/sortablejs ^1.15.5 development
- @types/spark-md5 ^3.0.4 development
- @vitejs/plugin-vue ^4.4.1 development
- @vue/eslint-config-typescript ^12.0.0 development
- @vue/tsconfig ^0.4.0 development
- eslint ^8.53.0 development
- eslint-plugin-vue ^9.18.1 development
- npm-run-all ^4.1.5 development
- sass ^1.69.5 development
- terser ^5.24.0 development
- typescript ^5.2.2 development
- vite ^4.5.0 development
- vite-plugin-compression ^0.5.1 development
- vite-plugin-css-injected-by-js ^3.3.0 development
- vue-tsc ^1.8.22 development
- @popperjs/core ^2.11.8
- bootstrap ^5.3.2
- bootstrap-icons-vue ^1.11.1
- mitt ^3.0.1
- sortablejs ^1.15.0
- spark-md5 ^3.0.2
- vue ^3.3.8
- vue-i18n ^9.6.5
- vue-router ^4.2.5
- 372 dependencies
- actions/stale v9 composite
- dessant/lock-threads v5 composite
- actions/checkout v5 composite
- actions/setup-node v4 composite
Score: 12.199561493914516