Dyness Battery – Home Assistant Integration

Eine Community-Integration für Home Assistant für Dyness Batteriespeicher über die Dyness Cloud API.

Hinweis / Note: Diese Integration nutzt die Dyness Open API (Cloud). Eine Internetverbindung ist erforderlich. Daten werden alle 5 Minuten aktualisiert (API-Limit).
This integration uses the Dyness Open API (Cloud). An internet connection is required. Data is updated every 5 minutes (API limit).

---

🇩🇪 Deutsch

Unterstützte Geräte

Gerät	Status
Dyness Cygni 10.0HS	✅ Getestet
Dyness DL5.0C	✅ Getestet
Dyness Junior Box	✅ Getestet
Dyness Powerbox G2 / Pro	✅ Getestet
Dyness PowerBrick / Plus / PRO / SC	✅ Getestet
Dyness PowerDepot G2 / H5B	✅ Getestet
Dyness PowerHaus	✅ Getestet
Dyness Stack100	✅ Getestet
Dyness Tower Pro TP7 / TP11 / TP15	✅ Getestet
Dyness Tower T14 / T17	✅ Getestet
Andere Dyness-Modelle mit WiFi-Dongle	⚠️ Nicht getestet – Feedback willkommen

Die Integration erkennt das Gerät automatisch über die API und registriert nur die Sensoren, die für das jeweilige Gerät verfügbar sind.

---

Verfügbare Sensoren

Pack-Ebene (Haupt-Device)

Die folgenden Sensoren sind für alle Geräte verfügbar:

Sensor	Einheit
Ladestand (SOC)	%
Leistung	W
Strom	A
Batteriestatus (Charging / Discharging / Standby)	–
Letzte Aktualisierung	Zeitstempel
Verbindungsstatus	Online / Offline
Betriebsstatus	–
Firmware-Version	–

Weitere Sensoren werden automatisch aktiviert, sofern das Gerät die Daten liefert:

Sensor	Einheit	Junior Box	Tower T14/T17/TP	DL5.0C / Stack100 / PowerBox Pro	PowerDepot G2 / H5B	PowerHaus	Powerbox G2	PowerBrick / PRO	PowerBrick SC / Plus
Pack-Spannung	V	✅	–	✅	✅	✅	✅	✅	✅
Batteriezustand (SOH)	%	✅	✅	✅	✅	✅	✅	✅	–
Temperatur	°C	–	–	–	–	–	✅	–	–
Temperatur Max	°C	✅	✅	✅	✅	✅	✅	✅	✅
Temperatur Min	°C	✅	✅	✅	✅	✅	✅	✅	✅
MOSFET-Temperatur	°C	✅	–	✅	✅	✅	✅	✅	✅
BMS-Temperatur Max	°C	✅	–	✅	✅	✅	✅	✅	✅
BMS-Temperatur Min	°C	✅	–	✅	✅	✅	✅	✅	✅
Zellspannung Max	V	✅	✅	✅	✅	✅	✅	✅	✅
Zellspannung Min	V	✅	✅	✅	✅	✅	✅	✅	✅
Zellspannungsdifferenz	mV	✅	✅	✅	✅	✅	✅	✅	✅
Zelle 01–16 (Einzelspannungen)	V	–	–	–	– ³	–	–	✅ ²	✅ ²
Nutzbare Kapazität	kWh	✅	✅	✅	✅	✅	✅	✅	✅
Verbleibende Energie	kWh	✅	✅	✅	✅	✅	✅	✅	✅
Ladezyklen	–	–	✅	✅	✅	✅	–	✅	✅
Heute geladen	kWh	✅	–	✅	–	–	–	–	–
Heute entladen	kWh	✅	–	✅	–	–	–	–	–
Gesamt geladen	kWh	✅	✅	✅	–	–	–	–	–
Gesamt entladen	kWh	✅	–	✅	–	–	–	–	–
Balancing-Status	–	✅	–	✅	–	–	–	–	–
Alarmstatus	–	✅	✅	✅	✅	✅	✅	✅	–
Ladespannungsgrenze	V	–	–	✅	✅	–	✅	✅	✅
Entladespannungsgrenze	V	–	–	✅	✅	–	✅	✅	✅
Max. Ladestrom	A	–	–	✅	✅	–	✅	✅	✅
Max. Entladestrom	A	–	–	✅	✅	–	✅	✅	✅

² Einzelne Zellspannungen (Zelle 01–16) sind standardmäßig deaktiviert und können in HA unter Einstellungen → Geräte & Dienste → Dyness Battery → Gerät → Entitäten aktiviert werden.

³ PowerDepot G2 / H5B: Einzelzellspannungen (Zelle 01–16) sind auf Modul-Ebene (Sub-Module Devices) verfügbar — nicht auf Pack-Ebene.

Modul-Ebene (Sub-Module Devices)

Geräte mit mehreren Modulen (DL5.0C, Stack100, PowerBox Pro, Tower T14, Tower Pro TP7/TP11/TP15) erstellen automatisch ein eigenes Device pro Modul:

Sensor	Einheit	DL5.0C / Stack100 / PowerBox Pro / PowerDepot	Tower T14/T17 / TP
Ladestand Modul (SOC)	%	✅	– ¹
Batteriezustand Modul (SOH)	%	✅	– ¹
Modul-Spannung	V	✅	– ¹
Modul-Strom	A	✅	– ¹
Ladezyklen Modul	–	✅	– ¹
Zellspannung Max	V	✅	✅
Zellspannung Min	V	✅	✅
Zellspannungsdifferenz	mV	✅	✅
Zelltemperatur 1	°C	✅	✅
Zelltemperatur 2	°C	✅	✅
Zelle 01–16 (DL5.0C / Stack100 / PowerBox Pro)	V	✅ ²	–
Zelle 01–30 (Tower T14/T17 / TP7/TP11/TP15)	V	–	✅ ²

¹ Tower T14/T17 / TP: SOC, SOH, Spannung, Strom und Zyklen sind nur auf Systemebene (Haupt-Device) verfügbar — die API liefert diese Werte nicht pro Modul.

² Einzelne Zellspannungen sind standardmäßig deaktiviert und können in HA unter Einstellungen → Geräte & Dienste → Dyness Battery → Gerät → Entitäten aktiviert werden.

---

Voraussetzungen

1. Dyness Batterie ist bereits in der Dyness App eingerichtet und online

Schritt 1: API-Zugangsdaten im Dyness Portal erstellen

1. Öffne Dyness Benutzer Smart Monitoring https://ems.dyness.com/login
2. Melde dich mit deinem Dyness-Konto an (dasselbe wie in der App)
3. Wähle im Menü links Entwicklerzentrum → API-Verwaltung
4. Klicke auf API Key erstellen
5. Notiere App ID und App Secret – das Secret wird nur einmal angezeigt!

Installation

Via HACS (empfohlen)

1. Öffne HACS in Home Assistant
2. Klicke auf Integrationen → ⋮ → Benutzerdefinierte Repositories
3. Repository-URL: https://github.com/shopf/dyness_battery — Kategorie: Integration
4. Suche nach Dyness Battery und installiere
5. Home Assistant neu starten

Manuelle Installation

1. Lade die ZIP von Releases herunter
2. Entpacke und kopiere custom_components/dyness_battery/ nach config/custom_components/
3. Home Assistant neu starten

Konfiguration

1. Einstellungen → Geräte & Dienste → Integration hinzufügen
2. Nach Dyness Battery suchen
3. Nur API ID und API Secret eintragen — das Gerät wird automatisch erkannt

Mehrere Batterien: Bei mehreren Batterien auf einem Account einfach die Integration erneut hinzufügen — dieselben API-Zugangsdaten, das zweite Gerät wird separat erkannt.

API Rate Limit & Scan-Intervall

Module	Intervall
1–2	5 Minuten
3–4	10 Minuten
5+	15 Minuten

Bekannte Einschränkungen

• Nur Monitoring – Steuerung (Ladezeiten, SOC-Grenzen) wird von der API nicht unterstützt
• Internetabhängig – Keine lokale Verbindung möglich

Neues Modell hinzufügen

Du hast ein anderes Dyness-Modell und möchtest es hinzufügen lassen? Erstelle ein Issue mit der Ausgabe des API-Testscripts tools/dyness_test.py.

---

🇬🇧 English

Supported Devices

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

The integration automatically detects the device via the API and only registers sensors available for that specific device.

---

Available Sensors

Pack Level (Main Device)

Available for all devices:

Sensor	Unit
State of Charge (SOC)	%
Power	W
Current	A
Battery Status (Charging / Discharging / Standby)	–
Last Update	Timestamp
Communication Status	Online / Offline
Work Status	–
Firmware Version	–

Additional sensors enabled automatically if provided by the device:

Sensor	Unit	Junior Box	Tower T14/T17/TP	DL5.0C / Stack100 / PowerBox Pro	PowerDepot G2 / H5B	PowerHaus	Powerbox G2	PowerBrick / PRO	PowerBrick SC / Plus
Pack Voltage	V	✅	–	✅	✅	✅	✅	✅	✅
State of Health (SOH)	%	✅	✅	✅	✅	✅	✅	✅	–
Temperature	°C	–	–	–	–	–	✅	–	–
Temperature Max	°C	✅	✅	✅	✅	✅	✅	✅	✅
Temperature Min	°C	✅	✅	✅	✅	✅	✅	✅	✅
MOSFET Temperature	°C	✅	–	✅	✅	✅	✅	✅	✅
BMS Temperature Max	°C	✅	–	✅	✅	✅	✅	✅	✅
BMS Temperature Min	°C	✅	–	✅	✅	✅	✅	✅	✅
Cell Voltage Max	V	✅	✅	✅	✅	✅	✅	✅	✅
Cell Voltage Min	V	✅	✅	✅	✅	✅	✅	✅	✅
Cell Voltage Spread	mV	✅	✅	✅	✅	✅	✅	✅	✅
Cell 01–16 (individual voltages)	V	–	–	–	– ³	–	–	✅ ²	✅ ²
Usable Capacity	kWh	✅	✅	✅	✅	✅	✅	✅	✅
Energy Remaining	kWh	✅	✅	✅	✅	✅	✅	✅	✅
Cycle Count	–	–	✅	✅	✅	✅	–	✅	✅
Energy Charged Today	kWh	✅	–	✅	–	–	–	–	–
Energy Discharged Today	kWh	✅	–	✅	–	–	–	–	–
Energy Charged Total	kWh	✅	✅	✅	–	–	–	–	–
Energy Discharged Total	kWh	✅	–	✅	–	–	–	–	–
Balancing Status	–	✅	–	✅	–	–	–	–	–
Alarm Status	–	✅	✅	✅	✅	✅	✅	✅	–
Charge Voltage Limit	V	–	–	✅	✅	–	✅	✅	✅
Discharge Voltage Limit	V	–	–	✅	✅	–	✅	✅	✅
Max Charge Current	A	–	–	✅	✅	–	✅	✅	✅
Max Discharge Current	A	–	–	✅	✅	–	✅	✅	✅

² Individual cell voltages (Cell 01–16) are disabled by default and can be enabled in HA under Settings → Devices & Services → Dyness Battery → Device → Entities.

³ PowerDepot G2 / H5B: Individual cell voltages (Cell 01–16) are available at module level (Sub-Module Devices) — not at pack level.

Module Level (Sub-Module Devices)

Devices with multiple modules (DL5.0C, Stack100, PowerBox Pro, Tower T14, Tower Pro TP7/TP11/TP15) automatically create a separate device per module:

Sensor	Unit	DL5.0C / Stack100 / PowerBox Pro / PowerDepot	Tower T14/T17 / TP
Module SOC	%	✅	– ¹
Module SOH	%	✅	– ¹
Module Voltage	V	✅	– ¹
Module Current	A	✅	– ¹
Module Cycle Count	–	✅	– ¹
Cell Voltage Max	V	✅	✅
Cell Voltage Min	V	✅	✅
Cell Voltage Spread	mV	✅	✅
Cell Temperature 1	°C	✅	✅
Cell Temperature 2	°C	✅	✅
Cell 01–16 (DL5.0C / Stack100 / PowerBox Pro)	V	✅ ²	–
Cell 01–30 (Tower T14/T17 / TP7/TP11/TP15)	V	–	✅ ²

¹ Tower T14/T17 / TP: SOC, SOH, Voltage, Current and Cycle Count are only available at system level (main device) — the API does not provide these values per module.

² Individual cell voltages are disabled by default and can be enabled in HA under Settings → Devices & Services → Dyness Battery → Device → Entities.

---

Step 1: Create API Credentials in the Dyness Portal

1. Open Dyness User Smart Monitoring https://ems.dyness.com/login
2. Log in with your Dyness account (same as the app)
3. Select Developer Center → API Management from the left menu
4. Click Create API Key
5. Note down App ID and App Secret – the secret is only shown once!

Installation

Via HACS (recommended)

1. Open HACS in Home Assistant
2. Click Integrations → ⋮ → Custom repositories
3. Add URL: https://github.com/shopf/dyness_battery — Category: Integration
4. Search for Dyness Battery and install
5. Restart Home Assistant

Manual Installation

1. Download the ZIP from Releases
2. Extract and copy custom_components/dyness_battery/ to config/custom_components/
3. Restart Home Assistant

Configuration

1. Settings → Devices & Services → Add Integration
2. Search for Dyness Battery
3. Enter only your API ID and API Secret — the device is discovered automatically

Multiple batteries: Simply add the integration again with the same credentials to set up additional batteries on the same account.

API Rate Limit & Scan Interval

Modules	Interval
1–2	5 minutes
3–4	10 minutes
5+	15 minutes

Known Limitations

• Monitoring only – Control (charge schedules, SOC limits) is not supported via the API
• Cloud dependent – No local connection possible

Adding a New Model

Open an Issue with the output of the API test script tools/dyness_test.py.

---

Technical Details

Uses the Dyness Open API v1.1 with HmacSHA1 authentication.

Endpoints used:

• POST /v1/device/storage/list – Auto-discover device SN and work status
• POST /v1/device/bindSn – Bind device to API key
• POST /v1/device/realTime/data – Real-time BMS data (every 5 min)
• POST /v1/device/getLastPowerDataBySn – Current power data (every 5 min)
• POST /v1/station/info – Station info (battery capacity)
• POST /v1/device/household/storage/detail – Device details (firmware, status)
• POST /v1/device/getLastRunningDataBySn – Runtime data (firmware version)

---

Community & Support

💬 Questions & Ideas	GitHub Discussions
🐛 Bug Reports	GitHub Issues
🔌 New Device	Open an Issue with your dyness_test.py output

---

Translations

Additional languages supported:

1. 🇫🇷 French — contributed by the community

---

License

MIT License – see LICENSE