Dyness Battery – Home Assistant Integration (Cloud API, HACS) [Updated]

Share your Projects! Custom Integrations
1

Dyness Battery – Home Assistant Integration (Cloud API, HACS) [Updated]

Hi everyone,

I’d like to share a custom Home Assistant integration I built for Dyness battery storage systems using the official Dyness Open API.

GitHub: GitHub - shopf/dyness_battery: Home Assistant Community Integration for Dyness Battery Storage · GitHub

What it does

The integration connects to the Dyness Cloud API and automatically detects your device — only sensors actually available for your specific model are registered.

Note: Cloud-based only, no local connection. Data updates every 5 minutes (API limit). Monitoring only — charge schedules and SOC limits are not controllable via the API.

Supported Devices

Device Status
Dyness Cygni 10.0HS :white_check_mark: Tested
Dyness DL5.0C :white_check_mark: Tested
Dyness Junior Box :white_check_mark: Tested
Dyness Powerbox G2 :white_check_mark: Tested
Dyness PowerBox Pro :white_check_mark: Tested
Dyness PowerHaus :white_check_mark: Tested
Dyness PowerBrick / PRO / SC / Plus :white_check_mark: Tested
Dyness Stack100 :white_check_mark: Tested
Dyness Tower Pro TP7 / TP11 / TP15 :white_check_mark: Tested
Dyness Tower T14 / T17 :white_check_mark: Tested
Other Dyness models with WiFi dongle :warning: Not tested – feedback welcome

Available Sensors

All devices provide SOC, Power, Current, Battery Status, Last Update, Connection Status, Work Status and Firmware Version.

Additional sensors are enabled automatically depending on your model: SOH, pack voltage, cell voltage min/max & spread, temperatures (cell, BMS, MOSFET), usable capacity, energy remaining, cycle count, today/total charged & discharged energy, balancing status, alarm status, and charge/discharge voltage & current limits.

Multi-module devices (DL5.0C, Stack100, PowerBox Pro, Tower T14/T17, Tower Pro TP7/TP11/TP15) create a separate HA device per module, including individual cell voltages (up to 30 cells, disabled by default).

Installation via HACS

  1. HACS → Integrations → ⋮ → Custom repositories
  2. URL: https://github.com/shopf/dyness_battery — Category: Integration
  3. Search for Dyness Battery and install
  4. Restart Home Assistant
  5. Settings → Devices & Services → Add Integration → Dyness Battery
  6. Enter your API ID and API Secret — device is discovered automatically

API credentials can be created for free in the Dyness portal at ems.dyness.com under Developer Center → API Management. :warning: The App Secret is only shown once!

Multiple batteries: Simply add the integration again with the same credentials — each device is discovered separately.

Update August 2026: 13 devices now tested (incl. PowerBrick series, Tower T17, TP11/TP15), multi-module support, 25+ sensors per device, individual cell voltages, French translation.

Feedback and contributions are very welcome. Hope this is useful for fellow Dyness users! :battery:

Best regards

3 Likes
2

A lot has happened in the meantime. New products are now supported:

Device Status
Dyness Junior Box :white_check_mark: Tested
Dyness Tower (non-pro) :white_check_mark: Tested
Dyness Tower T14 :white_check_mark: Tested
Dyness DL5.0C :white_check_mark: Tested
Dyness PowerHaus :white_check_mark: Tested
Dyness PowerBox Pro-Low :white_check_mark: This should work (community-tested). Implementation coming soon.

A large number of new sensors have been added, depending on the model.

Installation via HACS (custom repository): :point_right: https://github.com/shopf/dyness_battery

3

Hi,

I had been using this with 3no Power Depot HB5 and it worked great. However since the last update each module has duplicated and the entities are not available. The pack entities are still available. Can anyone offer any guidance?

image
image426×750 24.3 KB

image
image450×742 21.4 KB

image
image518×768 31.8 KB

4

Hi. I haven’t received any reports about the Power Depot HB5 device yet, so it isn’t fully supported at this time. It would be great if you could create an issue, run the test script, and upload it to GitHub. That will allow me to add the Power Depot HB5 device.
Regarding your comment after the last update: I made a mistake when adding a new model. Sorry.
Please install the new version 2.2.1 and check that everything is working properly. If you encounter any issues, please open an issue on GitHub as mentioned. Thanks.

5

Thanks Osiris09, I’ll take a look at the test script. Thanks for the great work, much appreciated.

6

Thank you @Osiris09 :folded_hands:
this is great! works like a charm with my Dyness TowerPro TP15

1 Like
7

I just want to thank you. Works great and gives me everything I want to know about my Tower Pro TP15!

1 Like
8

Hey @ptogher14 have you had a chance to look at my test script yet? I’m missing a log from a Power Depot HB5 so I can add the model. Please get in touch if you need any help.
Note: I outlined the general process for a German user three days ago — feel free to check it out in Issue 34.

9

Hi @Osiris09, i have been using the integration. It works well bar the remaining capcity and usable energy do not read correctly. The temperature appears unavailable since the last update. I'll take a look at the test script

1 Like