opendtu

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

https://github.com/tbnobody/opendtu

Science Score: 36.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
  • Academic publication links
  • Committers with academic emails
    1 of 71 committers (1.4%) from academic institutions
  • Institutional organization owner
  • JOSS paper metadata
  • Scientific vocabulary similarity
    Low similarity (9.5%) to scientific vocabulary

Keywords

balkonkraftwerk esp32 hoymiles mqtt platformio solar solenso tsun

Keywords from Contributors

interpretability projection interactive serializer measurement cycles packaging charts network-simulation archival
Last synced: 5 months ago · JSON representation

Repository

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

Basic Info
  • Host: GitHub
  • Owner: tbnobody
  • License: gpl-2.0
  • Language: C++
  • Default Branch: master
  • Homepage:
  • Size: 62.4 MB
Statistics
  • Stars: 2,027
  • Watchers: 49
  • Forks: 554
  • Open Issues: 154
  • Releases: 78
Topics
balkonkraftwerk esp32 hoymiles mqtt platformio solar solenso tsun
Created over 3 years ago · Last pushed 6 months ago
Metadata Files
Readme Funding License

README.md

OpenDTU

OpenDTU Build cpplint Yarn Linting

!! 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

code * 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

Owner

  • Login: tbnobody
  • Kind: user
  • Location: Germany

GitHub Events

Total
  • Fork event: 37
  • Create event: 142
  • Commit comment event: 8
  • Issues event: 213
  • Release event: 9
  • Watch event: 219
  • Delete event: 165
  • Issue comment event: 1,543
  • Push event: 10
  • Gollum event: 27
  • Pull request review event: 7
  • Pull request review comment event: 9
  • Pull request event: 321
Last Year
  • Fork event: 37
  • Create event: 142
  • Commit comment event: 8
  • Issues event: 213
  • Release event: 9
  • Watch event: 219
  • Delete event: 165
  • Issue comment event: 1,543
  • Push event: 10
  • Gollum event: 27
  • Pull request review event: 7
  • Pull request review comment event: 9
  • Pull request event: 321

Committers

Last synced: 6 months ago

All Time
  • Total Commits: 2,030
  • Total Committers: 71
  • Avg Commits per committer: 28.592
  • Development Distribution Score (DDS): 0.123
Past Year
  • Commits: 390
  • Committers: 15
  • Avg Commits per committer: 26.0
  • Development Distribution Score (DDS): 0.231
Top Committers
Name Email Commits
Thomas Basler t****s@f****t 1,780
Bernhard Kirchen s****n@p****t 63
Martin Dummer m****r@g****t 20
LennartF22 1****2 18
dependabot[bot] 4****] 13
Axel Hinrichs h****s@b****e 12
Stefan Oberhumer s****n@o****m 10
Markus Krause K****s@g****m 10
Nikolaj Kappler i****o@n****e 8
Marc-Philip m****6@g****e 7
fischaxe a****l@m****e 4
Tobias Diedrich r****t@t****e 3
0lini 7****i 3
Stefan Schultheis, OE1SCS s****i 3
Timo Schindler t****o@b****e 3
jstammi j****i@g****t 3
Luca Kröger l****r@p****e 3
Michael Wilk m****k@m****h 3
vaterlangen v****n@d****e 2
Stefan Kreutter s****r@f****e 2
CommanderRedYT c****d@g****m 2
Daedalus 3****r 2
Moritz 2****l 2
Peter Lieven pl@d****e 2
Pierre Kancir p****n@g****m 2
Sabouflage s****e 2
helgeerbe h****e@e****e 2
mbo18 m****8 2
stefan123t s****t 2
Bernhard Roth b****h@r****e 1
and 41 more...

Issues and Pull Requests

Last synced: 6 months ago

All Time
  • Total issues: 444
  • Total pull requests: 700
  • Average time to close issues: 3 months
  • Average time to close pull requests: 22 days
  • Total issue authors: 337
  • Total pull request authors: 78
  • Average comments per issue: 6.33
  • Average comments per pull request: 1.75
  • Merged pull requests: 68
  • Bot issues: 4
  • Bot pull requests: 497
Past Year
  • Issues: 138
  • Pull requests: 412
  • Average time to close issues: 16 days
  • Average time to close pull requests: 3 days
  • Issue authors: 115
  • Pull request authors: 23
  • Average comments per issue: 3.66
  • Average comments per pull request: 1.36
  • Merged pull requests: 22
  • Bot issues: 3
  • Bot pull requests: 342
Top Authors
Issue Authors
  • broth-itk (6)
  • schlimmchen (6)
  • grasmax (6)
  • Elektron79 (6)
  • Juergen2453 (5)
  • AloisKlingler (5)
  • Fokker-1 (5)
  • itn3rd77 (5)
  • hubsi5 (4)
  • DejanBukovec (4)
  • dependabot[bot] (4)
  • andreas-bulling (4)
  • Gitsarry (4)
  • svalcken (4)
  • stefan123t (3)
Pull Request Authors
  • dependabot[bot] (497)
  • schlimmchen (30)
  • LennartF22 (11)
  • ahinrichs (10)
  • stefan123t (7)
  • ranma (7)
  • HacksBugsAndRockAndRoll (6)
  • StefanOberhumer (5)
  • CommanderRedYT (5)
  • mpw96 (4)
  • madmartin (4)
  • foroae (4)
  • marvincarstensen (4)
  • kindyy (4)
  • crashcoq (4)
Top Labels
Issue Labels
bug (254) enhancement (130) stale (27) dependencies (4) javascript (4) contribution needed (1)
Pull Request Labels
dependencies (497) javascript (488) github_actions (9) bug (3) enhancement (3)

Dependencies

.github/workflows/build.yml actions
  • 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
.github/workflows/cpplint.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
.github/workflows/yarnlint.yml actions
  • actions/checkout v3 composite
  • actions/setup-node v3 composite
webapp/package.json npm
  • @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
webapp/yarn.lock npm
  • 372 dependencies