MQTT + Deye: 2 Methoden zur Integration Ihres Wechselrichters in die Hausautomation

Das Problem: Deye unterstützt MQTT nicht von Haus aus

Sie haben einen Deye-Hybrid-Wechselrichter (SUN-5K, 8K, 10K, 12K oder 20K) installiert und möchten dessen Produktions-, Verbrauchs- und Batteriestatusdaten in Ihr Hausautomationssystem integrieren – Home Assistant, Domoticz, Jeedom oder Node-RED.

Natürlich suchen Sie in der offiziellen Deye-Dokumentation nach einer MQTT-Konfiguration, einem zu konfigurierenden Topic… und finden nichts. Das ist normal: Deye stellt keinen nativen MQTT-Broker zur Verfügung. Der mit dem Wechselrichter gelieferte WiFi-Logger-Stick kommuniziert nur mit einem einzigen Ansprechpartner: der Solarman-Cloud. Kein lokales Topic, keine dokumentierte API für die Hausautomation.

Dieser Artikel beschreibt die beiden Ansätze, ihre Vorteile, ihre technischen Grenzen und ihre konkrete Umsetzung für eine Wohn- oder Gewerbebranchenanlage in Belgien und Frankreich.

Wo werden die Daten in einem Deye-Wechselrichter gespeichert?

Bevor Sie sich für eine Methode entscheiden, sollten Sie die Kommunikationsarchitektur eines Deye-Hybrid-Wechselrichters verstehen:

• Interne Modbus-Register (~300 Register): DC-/AC-Spannungen pro Phase, Ströme, Momentanleistungen, Batterieladezustand (SOC), Temperatur, Tages-/Gesamtenergiezähler, Fehlercodes.
• Physikalischer RS485-Anschluss (RJ45-Stecker oder Klemmleiste je nach Modell): Modbus-RTU-Ausgang, direkt vom Wechselrichter aus zugänglich.
• Stick Logger (2,4-GHz-WLAN-Dongle oder RJ45-Ethernet): Wird in den internen Steckplatz des Wechselrichters gesteckt, liest die Modbus-Register über UART aus und sendet sie über das Internet an die Solarman Cloud.

Der Stick Logger stellt außerdem einen undokumentierten TCP-Port 8899 bereit, der den Modbus/TCP-Zugriff über das lokale Netzwerk ermöglicht. Diesen Port werden wir in der ersten Methode nutzen.

┌──────────────────────────────────────────────┐
│         Deye-Wechselrichter SUN-5K bis 20K           │
│                                              │
│   ┌─────────────┐        ┌─────────────┐     │
│   │  Register  │──RS485─│  COM-Port   │     │
│   │   Modbus    │        │  (RJ45/DB9) │     │
│   │  (~300)     │──UART──│ Stick       │     │
│   └─────────────┘        │ Logger-Steckplatz │     │
│                          └──────┬──────┘     │
└─────────────────────────────────┼────────────┘
                                  │
                    Stick-Logger (WLAN/Ethernet)
                                  │
                    ┌─────────────┴─────────────┐
                    │                           │
              TCP 8899 (LAN)            Solarman Cloud
            ← Methode 1 nutzt         (mobile App)
               diesen lokalen Port

Die beiden Methoden in diesem Artikel nutzen zwei verschiedene Zugriffspfade auf dieselben Modbus-Register.

Methode 1 – Software-Bridge über WiFi-Logger-Stick (TCP-Port 8899)

Funktionsprinzip

Der Deye Stick Logger (Modelle LSW-3, LSW-5, LSE-3) verfügt über einen integrierten Modbus/TCP-Server, der auf Port 8899 seiner lokalen IP-Adresse lauscht. Dieser Port ist von Deye nicht offiziell dokumentiert, aber er ist stabil und wird seit mehreren Jahren von der gesamten Open-Source-Community genutzt.

Man installiert eine Bridge-Software im lokalen Netzwerk – typischerweise auf einem Raspberry Pi, einem Synology/QNAP-NAS, einem Mini-PC oder einem vorhandenen Server –, die:

1. eine TCP-Verbindung zur IP-Adresse des Stick Loggers auf Port 8899 herstellt
2. die konfigurierten Modbus-Register in einer Schleife (alle 30–60 Sekunden) abfragt
3. Jede Metrik als MQTT-Topic an einen lokalen Broker (z. B. Mosquitto) weiterleitet

Das Referenz-Open-Source-Projekt ist deye-inverter-mqtt (kbialek auf GitHub), kompatibel mit der gesamten ein- und dreiphasigen SG01/SG04/SG05-Reihe.

Schema von Methode 1

Deye SUN-20K ──(internes Kabel)── WiFi-Logger-Stick ──LAN─┐
                                                         │
                               TCP 8899 (Modbus/TCP)     │
                                                         ▼
                                          ┌──────────────────────┐
                                          │ deye-inverter-mqtt   │
                                          │ (Docker/Python)      │
                                          │ 192.168.1.100        │
                                          └──────────┬───────────┘
                                                     │ publish
                                                     ▼
                                            ┌────────────────┐
                                            │   Mosquitto    │
                                            │   (Broker)     │
                                            └────────┬───────┘
                                                     │ abonnieren
                                                     ▼
                                ┌────────────────────────────────┐
                                │ Home Assistant / Domoticz /    │
                                │ Jeedom / Node-RED / Grafana    │
                                └────────────────────────────────┘

Hardware- und Softwarevoraussetzungen

Vorteile von Methode 1

• ✅ Schnelle Installation: 10–15 Minuten, keine physische Verkabelung
• ✅ Kein Eingriff am Wechselrichter: kein Ausbau, keine elektrische Gefahr
• ✅ Freier COM-Port: Der physische RS485-Port bleibt für einen externen Zähler (Chint DTSU666) oder eine erweiterte BMS-Batteriesteuerung verfügbar
• ✅ Funktioniert über WLAN: ideal, wenn sich der Wechselrichter in der Garage und die Hausautomationsbox im Büro befindet, ohne dass ein Ethernet-Kabel verlegt werden muss
• ✅ Kompatibel mit Solarman: Der Stick Logger sendet weiterhin Daten an die Cloud – Sie behalten die offizielle mobile App
• ✅ Keine Anschaffung von Hardware: Alles läuft über Software auf vorhandenen Geräten

Einschränkungen und Vorsichtsmaßnahmen

• ⚠️ Abhängigkeit vom Stick Logger: Wenn der WLAN-Dongle abstürzt, neu startet oder die Netzwerkverbindung verliert, wird der MQTT-Datenstrom unterbrochen, bis er wieder online ist
• ⚠️ Latenz von 5–10 Sekunden: Die Modbus-Abfrage über TCP verursacht eine leichte Verzögerung – ideal für die Überwachung, jedoch nur bedingt geeignet für die Echtzeitsteuerung mit dynamischen Tarifen
• ⚠️ Nur Lesezugriff bei bestimmten Firmware-Versionen: Die meisten Stick Logger erlauben kein Schreiben von Registern über Port 8899 – es ist nicht möglich, den Modus des Wechselrichters (TOU, Backup, Self-Use) über MQTT zu ändern
• ⚠️ Aktuelle Solarman V5-Firmware: Bei den Chargen 2024–2025 erfordern einige Firmware-Versionen einen proprietären Handshake – die Bridge deye-inverter-mqtt unterstützt dieses Protokoll durch die Konfiguration von DEYE_LOGGER_PROTOCOL: solarman_v5
• ⚠️ Nur 2,4-GHz-WLAN: Der Stick Logger erkennt keine 5-GHz-Netzwerke – wenn Ihre Mesh-Box (Fritz!, Orbi, Deco) 2,4 und 5 GHz unter einer einzigen SSID zusammenfasst, erzwingen Sie vorübergehend eine separate 2,4-GHz-SSID für die Kopplung

Veröffentlichte MQTT-Topics

Hier sind die wichtigsten von deye-inverter-mqtt generierten Themen (konfigurierbares Präfix, hier solar/deye//):

Insgesamt stehen je nach Modell (SG01/SG04/SG05) etwa 80 Metriken zur Verfügung, die über die Datei metrics.yaml des Projekts vollständig anpassbar sind.

Beispiel für eine Docker-Konfiguration

Erstellen Sie eine Datei docker-compose.yml auf Ihrem Host (Raspberry Pi, NAS…):

services:
  deye-mqtt:
    image: ghcr.io/kbialek/deye-inverter-mqtt:latest
    container_name: deye-bridge
    restart: unless-stopped
    environment:
      LOG_LEVEL: INFO
      # IP-Adresse des Logger-Sticks in Ihrem LAN
      DEYE_LOGGER_IP_ADDRESS: 192.168.1.50
      DEYE_LOGGER_PORT: 8899
      # Seriennummer, sichtbar in der Solarman-App
      DEYE_LOGGER_SERIAL_NUMBER: 2712345678
      # Protokoll: modbus_tcp (alt) oder solarman_v5 (aktuelle Firmware)
      DEYE_LOGGER_PROTOCOL: modbus_tcp
      # Adresse Ihres Mosquitto-Brokers
      MQTT_HOST: 192.168.1.10
      MQTT_PORT: 1883
      MQTT_USERNAME: homeassistant
      MQTT_PASSWORD: Ihr_Passwort
      # Präfix der veröffentlichten Themen
      MQTT_TOPIC_PREFIX: solar/deye
      # Metrikgruppe: deye_hybrid (SG04/SG05) oder deye_sg01 (mono)
      DEYE_METRIC_GROUPS: deye_hybrid
      # Abtastintervall (in Sekunden)
      DEYE_DATA_READ_INTERVAL: 60

Starten Sie den Container: docker-compose up -d

Logs anzeigen: docker logs -f deye-bridge

Wenn alles korrekt ist, sehen Sie Zeilen wie:

INFO - 78 Metriken erfolgreich von Logger 2712345678 gelesen
INFO - Veröffentlicht: solar/deye/2712345678/ac/active_power: 4320
INFO - Veröffentlicht: solar/deye/2712345678/battery/soc: 82

Methode 2 – Modbus-RTU-Gateway über physischen RS485-Anschluss

Funktionsprinzip

Der Stick Logger wird komplett umgangen und man schließt sich direkt an den RS485-Kommunikationsanschluss des Wechselrichters an (RJ45-Stecker oder Klemmenleiste „RS485-A / RS485-B“, je nach Deye-Modell).

Man installiert ein Modbus-RTU-→-Modbus-TCP-Gateway (RS485-zu-Ethernet-Konverter), das:

1. über ein abgeschirmtes Twisted-Pair-Kabel (gekreuztes RJ45-Kabel oder Schraubklemmen) physisch mit dem COM-Anschluss des Wechselrichters verbunden wird
2. einen Modbus/TCP-Server im lokalen Netzwerk bereitstellt (IP-Adresse des Gateways)
3. Die gleiche Software-Bridge (oder Node-RED mit node-red-contrib-modbus) fragt dieses Gateway ab und veröffentlicht die Daten erneut über MQTT

Schema von Methode 2

Deye SUN-20K ──RS485 A/B── Modbus-Gateway ──Ethernet──┐
     (COM-Port)           (Waveshare, USR,               │
                           Elfin, Moxa…)                 │
                           192.168.1.60                  │
                                                         ▼
                                          ┌──────────────────────┐
                                          │  deye-inverter-mqtt  │
                                          │  (TCP-Gateway-Modus)  │
                                          │   ODER                 │
                                          │  Node-RED +          │
                                          │  node-red-contrib-   │
                                          │   modbus             │
                                          └──────────┬───────────┘
                                                     │
                                                     ▼
                                            Mosquitto → Hausautomation

Erforderliche Hardware

Verkabelung des Deye-RS485-Anschlusses

Für die Modelle SG04LP3 und SG05LP3 (RJ45-Anschluss mit der Bezeichnung „RS485“ oder „BMS“):

Serielle Einstellungen: 9600 Baud, 8 Bit, keine Parität, 1 Stoppbit (8N1), Slave-ID = standardmäßig 1 (im Menü des Wechselrichters überprüfen).

Vorteile von Methode 2

• ✅ Vollständige Unabhängigkeit vom Stick Logger: Sie können ihn entfernen, austauschen oder parallel für Solarman behalten – der lokale Modbus-Datenstrom läuft weiter
• ✅ Lese- UND Schreibzugriff: Möglichkeit, den Wechselrichter über MQTT zu steuern (Umschaltung zwischen den Modi TOU/Self-Use/Backup, Sollwert für Ziel-SOC, Begrenzung der Netzeinspeisung…)
• ✅ Latenz von 1–2 Sekunden: ideal für die Echtzeitsteuerung (Dynamic ESS, skriptgesteuertes Peak Shaving, Reaktion auf dynamische SPOT-Tarife von Tibber oder EPEX)
• ✅ Keine Abhängigkeit von Cloud oder WLAN: funktioniert auch ohne Internet, stabiles kabelgebundenes lokales Netzwerk
• ✅ Industrielle Zuverlässigkeit: Die professionellen Modbus-Gateways (Moxa, Elfin) sind dafür ausgelegt, jahrelang rund um die Uhr ohne Wartung zu laufen

Einschränkungen und Vorsichtsmaßnahmen

• ⚠️ Zusätzliche Hardware: Kauf eines Gateways (25–80 €) und physische Verkabelung am Wechselrichter
• ⚠️ Belegt den COM-Port: Wenn der RS485-Port bereits von einem externen Chint DTSU666-Zähler oder einem fortschrittlichen BMS-Batteriemanagementsystem genutzt wird, ist Multiplexing erforderlich (komplexer, erfordert einen RS485-Hub)
• ⚠️ Unterbricht die Solarman-Überwachung, wenn der Stick Logger abgezogen ist: Beide können jedoch nebeneinander betrieben werden, wenn der Wechselrichter über zwei RS485-Anschlüsse verfügt (wie beim aktuellen SG05)
• ⚠️ Erforderliche elektrotechnische Kenntnisse: RJ45-Crimpen, Identifizierung der A/B-Signale, Aktivierung des Abschlusswiderstands – nicht geeignet, wenn Sie noch nie mit RS485 gearbeitet haben
• ⚠️ Eingriff in den Schaltschrank: Der Wechselrichter muss spannungsfrei sein, um den COM-Anschluss sicher zu verkabeln

Typische Anwendungsfälle für Methode 2

Diese Methode richtet sich an Installateure und fortgeschrittene Privatanwender, die über die reine Überwachung hinausgehen möchten:

• Dynamische Steuerung des zweistufigen Tarifs (Wallonien, France Tempo): Erzwingen der Batterieladung in Nebenzeiten über Modbus-Registereinträge
• Skriptgesteuertes Peak Shaving: Begrenzung der Netzeinspeisung, wenn der Vertrag einen Schwellenwert vorschreibt (Anlagen > 10 kVA)
• Maßgeschneiderte Eigenverbrauchsstrategie: Automatisches Umschalten zwischen den Modi „Self-Use“, „TOU“ und „Backup“ je nach Uhrzeit/Ladezustand/Wetter
• Integration in industrielle ERP-/SCADA-Systeme: Überwachung mehrerer Standorte mit Modbus-Rückmeldung an Fachsoftware (Schneider, Siemens, ABB)
• Cloud-Unabhängigkeit: netzunabhängige Installation oder Verzicht auf die Überwachung durch Solarman

Vergleichstabelle: Welche Methode soll man wählen?

Schnellentscheidungshilfe

In der Praxis sind 90 % der privaten Anlagen (Privathaushalte, kleine Gewerbebetriebe) mit Methode 1 bestens bedient. Sie erfordert weder Hardware noch Kabel und liefert alle relevanten Messwerte.

Methode 2 wird unverzichtbar, wenn es um aktive Steuerung geht, typischerweise um dynamische Tarife in Wallonien (Tibber-, Mega-, Bolt-Vertrag) zu nutzen oder um Peak Shaving bei dreiphasigen Anlagen > 10 kVA zu industrialisieren.

Integration auf der Hausautomationsseite

Sobald die MQTT-Topics auf Ihrem Mosquitto-Broker veröffentlicht sind, verfügt jede Hausautomationsplattform über ihren eigenen Integrationsmechanismus:

Domoticz

MQTT Auto Discover -Plugin oder MQTT Client Gateway: halbautomatische Erstellung virtueller Geräte anhand der Topics. Konfiguration unter Einstellungen → Hardware → Hinzufügen → MQTT Client Gateway.

Home Assistant

Integriertes Mosquitto-Broker-Add-on + YAML-Konfiguration für MQTT: in configuration.yaml oder Nutzung des Auto-Discovery-Mechanismus über das Präfix homeassistant/. Die Entitäten werden automatisch in der Lovelace-Oberfläche erstellt.

Jeedom

jMQTT-Plugin: Hinzufügen des Mosquitto-Brokers, Abonnieren der Topics solar/deye/#, manuelle oder automatische Erstellung der Befehle info/action in den virtuellen Geräten.

Node-RED

Standard -MQTT-In- Knoten zum Abonnieren von Topics, Function -Knoten zum Parsen und Formatieren der JSON-Payloads, MQTT-Out- Knoten zum Weiterleiten oder Schreiben in Protokolle (nur Methode 2).

Grafana + InfluxDB

Telegraf im MQTT-Consumer-Modus ([[inputs.mqtt_consumer]]), Senden an InfluxDB-Datenbank, zu 100 % anpassbare Dashboards in Grafana für Echtzeitüberwachung und Historien.

Kompatibilität des WiFi-Stick-Loggers: Modelle und Firmware

Alle originalen Deye WiFi-Stick-Logger stellen den TCP-Port 8899 bereit, unabhängig vom physikalischen Medium (2,4-GHz-WLAN oder RJ45-Ethernet):

Zwei Vorsichtsmaßnahmen bei einem WiFi-Logger

1. Feste IP-Adresse (DHCP reserviert): Reservieren Sie auf Ihrer Internet-Router die MAC-Adresse des Stick Loggers, um zu verhindern, dass sich die IP-Adresse nach einem Neustart des Routers ändert (ansonsten zeigt die Bridge ins Leere).
2. Eigenes 2,4-GHz-Netzwerk oder vom 5-GHz-Netzwerk getrennt: Die Stick Logger erkennen keine 5-GHz-SSIDs. Wenn Ihre Mesh-Box (Fritz!Box, Orbi, Deco) 2,4 und 5 GHz unter einer einzigen SSID zusammenfasst, erzwingen Sie vorübergehend eine separate 2,4-GHz-SSID für die erstmalige Kopplung.

Aktuelle Solarman V5-Firmware (2024–2025)

Bei einigen Chargen des LSW-3 mit Firmware ≥ MW3_16_5406_1.90 hat Deye begonnen, den Port 8899 zu filtern, indem ein proprietärer Handshake (Solarman-V5-Protokoll) verlangt wird. Das Projekt deye-inverter-mqtt behandelt diesen Fall: Es reicht aus, die Umgebungsvariable zu konfigurieren:

DEYE_LOGGER_PROTOCOL: solarman_v5

anstelle von modbus_tcp. Dies ist funktional transparent, es müssen lediglich zwei Zeilen in der Konfiguration angepasst werden.

Häufig gestellte Fragen (FAQ)

Kann ich beide Methoden gleichzeitig verwenden?

Ja, wenn Ihr Deye-Wechselrichter über zwei RS485-Anschlüsse verfügt (wie beim aktuellen SG05). Sie behalten den Stick Logger für Solarman Cloud + MQTT über Methode 1 und schließen ein RS485-Gateway an den zweiten COM-Anschluss für die Steuerung an (Methode 2). Dies ist die umfassendste Konfiguration für eine gewerbliche Anlage oder einen Installateur, der sowohl die mobile Client-App als auch die erweiterte Steuerung nutzen möchte.

Kann der WiFi-Stick-Logger abstürzen oder die Verbindung verlieren?

Ja, wie jedes andere 2,4-GHz-WLAN-Gerät der unteren Preisklasse. Häufige Ursachen: Neustart der Internet-Router (der Logger benötigt 1–2 Minuten, um die Verbindung wiederherzustellen), Störungen (Mikrowellen, Bluetooth), Betonwand zwischen Wechselrichter und Router, instabile Firmware. Lösung: Feste IP-Adresse, WLAN-Repeater in der Nähe oder Umstellung auf Ethernet mit PLC-Adapter, falls keine RJ45-Verkabelung möglich ist.

Kann ich den Deye-Wechselrichter über MQTT mit Methode 1 steuern?

Nein** bei den meisten aktuellen Stick-Logger-Firmware-Versionen. Port 8899 ist schreibgeschützt. Zum Schreiben von Registern (Moduswechsel, SOC-Sollwert, Einspeisebegrenzung) muss Methode 2 (RS485-Gateway) verwendet werden, die vollen Modbus-Zugriff ermöglicht.

Funktioniert die Bridge mit den einphasigen Deye-Wechselrichtern (SG01, SG02)?

Ja, das Projekt deye-inverter-mqtt ist mit allen Serien kompatibel: SG01LP1 (einphasig, Niederspannung), SG02LP1 (einphasig, 10 kW), SG04LP3 (dreiphasig), SG05LP1 (einphasig, Mehrnetz), SG05LP3 (dreiphasig). Sie müssen lediglich die Variable DEYE_METRIC_GROUPS an Ihr Modell anpassen (deye_sg01, deye_sg04, deye_hybrid…).

Kann ich Home Assistant mit der Bridge verwenden?

Auf jeden Fall. Home Assistant integriert Mosquitto nativ (offizielles Add-on). Sobald die Bridge eingerichtet ist, konfigurieren Sie die MQTT-Integration in Home Assistant, und die Entitäten werden automatisch per Auto-Discovery erstellt, wenn Sie das Präfix homeassistant/ in deye-inverter-mqtt aktivieren.

Wie hoch ist der Stromverbrauch der Bridge?

Ein Raspberry Pi 3 oder 4 verbraucht im Leerlauf etwa 2–5 W, der Docker-Container deye-inverter-mqtt beansprucht durchschnittlich ~30 MB RAM und 0,1 % CPU. Im Vergleich zur PV-Produktion vernachlässigbar (einige kWh/Jahr). Wenn Sie bereits über ein NAS oder einen Hausautomationsserver verfügen, der rund um die Uhr läuft, verbraucht die Bridge praktisch keinen zusätzlichen Strom.

Fazit: Deye ist nicht geschlossen, sondern an beiden Enden offen

Der Deye-Wechselrichter ist kein proprietäres Silo: Er stellt alle seine Daten im Standard-Modbus-RTU-Format bereit, mit zwei nutzbaren Schnittstellen – Netzwerk über Stick Logger (TCP 8899) und RS485 über einen physischen COM-Port. Deye hat einfach nie in ein offenes Hausautomations-Ökosystem investiert: Sie konzentrieren sich auf Solarman Cloud und überlassen es der Open-Source-Community, die Lücke zu füllen.

Für 99 % der Privatanwender ist Methode 1 (TCP-8899-Bridge + Mosquitto) die richtige Lösung: keine Hardware, keine Verkabelung, umfangreiche MQTT-Topics auf Ihrem Broker in nur 10 Minuten. Solarman behalten wir parallel für die mobile App und die Herstellergarantie.

Für Enthusiasten und Installateure, die steuern und nicht nur beobachten wollen – um das Beste aus einem Tibber- oder Mega-Vertrag oder einem zweistündigen Tarif Wallonie 2026 herauszuholen –, ist Methode 2 (RS485-Gateway) unverzichtbar. Rechnen Sie mit einem Nachmittag für die Integration, 50 € für die Hardware und der vollständigen Kontrolle über Ihre Energieanlage.

In beiden Fällen entscheidet Ihre Hausautomation, sobald die Daten in Mosquitto sind, was damit geschehen soll: Echtzeit-Dashboard, Automatisierungen bei SOC-Schwellenwerten, maßgeschneiderte Eigenverbrauchsstrategien, Steuerung in Nebenzeiten, skriptgesteuertes Peak Shaving. Der Deye wird wieder zu dem, was er im Grunde ist – ein standardisierter industrieller Modbus-Controller – und nicht mehr eine chinesische Blackbox.

„Wir haben 12 dreiphasige Deye SUN-12K-Wechselrichter für ein Rechenzentrum in Lüttich integriert. Die Solarman-Überwachung für Endverbraucher reichte für die SCADA-Überwachung nicht aus. Dank der Moxa-RS485-Gateways und der Modbus/MQTT-Integration konnten wir alle Kennzahlen an unser EMS weiterleiten und das Peak Shaving in Echtzeit steuern. Die Latenz von 1 Sekunde macht den entscheidenden Unterschied, wenn man auf eine Verbrauchsspitze reagieren muss.“ — Jean-Marc D., Installateur im Dienstleistungssektor, Wallonien

Wattuneed SPRL
Rue Henripré 12, 4821 Andrimont, Belgien
Tel.: +32 87 45 00 34 – info@wattuneed.com
www.wattuneed.com | Technischer Support