Dyness Battery – Custom Integration for Home Assistant
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.
What it does
The integration connects to the Dyness Cloud API and provides the following sensors:
- State of Charge (%)
- Power (W) — positive = charging, negative = discharging
- Current (A)
- Battery Capacity (kWh)
- Installed PV Power (kW)
- Communication Status (Online/Offline)
- Work Status (e.g. RunMode, StandBy)
- Firmware Version
- Last Update / Data Timestamp
Installation via HACS
- HACS → Integrations → ⋮ → Custom repositories
- URL:
https://github.com/shopf/dyness_battery— Category: Integration - Search for Dyness Battery and install
- Restart Home Assistant
- Settings → Devices & Services → Add Integration → Dyness Battery
API credentials can be created for free in the Dyness portal at ems.dyness.com under Developer Center → API Management.
Tested with
| Device | Status |
|---|---|
| Dyness Junior Box |  Tested |
| Other Dyness models with WiFi dongle |  Not tested yet |
If you have a different Dyness model, please run the included test script (tools/dyness_test.py) and open an issue on GitHub with the output — I’d love to expand support to other models!
Feedback and contributions are very welcome. Hope this is useful for fellow Dyness users! 
Best regards
