MQTT + Deye: 2 manieren om uw omvormer in uw domoticasysteem te integreren

Het probleem: Deye ondersteunt MQTT niet standaard

U hebt een Deye hybride omvormer (SUN-5K, 8K, 10K, 12K of 20K) geïnstalleerd en u wilt de productie-, verbruiks- en batterijstatusgegevens ervan integreren in uw domoticasysteem — Home Assistant, Domoticz, Jeedom of Node-RED.

U zoekt natuurlijk in de officiële Deye-documentatie naar een MQTT-instelling, een topic om te configureren... en u vindt niets. Dat is normaal: Deye biedt geen native MQTT-broker. De WiFi Logger Stick die bij de omvormer wordt geleverd, communiceert slechts met één partner: de Solarman-cloud. Geen lokaal topic, geen gedocumenteerde API voor domotica.

Dit artikel beschrijft beide benaderingen, hun voordelen, hun technische beperkingen en de concrete implementatie ervan voor een residentiële of tertiaire installatie in België en Frankrijk.

Waar worden de gegevens in een Deye-omvormer opgeslagen?

Voordat u een methode kiest, is het belangrijk om de communicatiearchitectuur van een Deye hybride omvormer te begrijpen:

• Interne Modbus-registers (~300 registers): DC/AC-spanningen per fase, stromen, momentane vermogens, SOC van de batterij, temperatuur, dagelijkse/totale energiemeters, foutcodes.
• Fysieke RS485-poort (RJ45-connector of klemmenblok, afhankelijk van het model): Modbus RTU-uitgang die rechtstreeks vanaf de omvormer toegankelijk is.
• Stick Logger (2,4 GHz wifi-dongle of RJ45-ethernet): aangesloten op de interne sleuf van de omvormer, leest de Modbus-registers in UART en stuurt deze via internet naar Solarman Cloud.

De Stick Logger heeft ook een niet-gedocumenteerde TCP-poort 8899 die Modbus/TCP-toegang vanaf het lokale netwerk mogelijk maakt. Dit is de poort die we in de eerste methode gaan gebruiken.

┌──────────────────────────────────────────────┐
│         Deye SUN-5K tot 20K omvormer           │
│                                              │
│   ┌─────────────┐        ┌─────────────┐     │
│   │  Registers  │──RS485─│  COM-poort   │     │
│   │   Modbus    │        │  (RJ45/DB9) │     │
│   │  (~300)     │──UART──│ Stick       │     │
│   └─────────────┘        │ Loggersleuf │     │
│                          └──────┬──────┘     │
└─────────────────────────────────┼────────────┘
                                  │
                    Stick Logger (WiFi/Ethernet)
                                  │
                    ┌─────────────┴─────────────┐
                    │                           │
              TCP 8899 (LAN)            Solarman Cloud
            ← Methode 1 maakt gebruik van         (mobiele app)
               deze lokale poort

De twee methoden in dit artikel maken gebruik van twee verschillende toegangswegen naar dezelfde Modbus-registers.

Methode 1 — Softwarebridge via WiFi-stick (TCP-poort 8899)

Werkingsprincipe

De Deye Stick Logger (modellen LSW-3, LSW-5, LSE-3) bevat een Modbus/TCP-server die luistert op poort 8899 van zijn lokale IP-adres. Deze poort is niet officieel gedocumenteerd door Deye, maar is stabiel en wordt al enkele jaren door de hele open-sourcegemeenschap gebruikt.

Er wordt bridge-software geïnstalleerd op het lokale netwerk — meestal een Raspberry Pi, een Synology/QNAP NAS, een mini-pc of een bestaande server — die:

1. Een TCP-verbinding opent naar het IP-adres van de Stick Logger op poort 8899
2. De geconfigureerde Modbus-registers continu (elke 30-60 seconden) opvraagt
3. Elke meetwaarde opnieuw publiceert als een MQTT-topic naar een lokale broker (bijvoorbeeld Mosquitto)

Het toonaangevende open source-project is deye-inverter-mqtt (kbialek op GitHub), compatibel met het volledige assortiment SG01/SG04/SG05 eenfasige en driefasige omvormers.

Schema van methode 1

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

Hardware- en softwarevereisten

Voordelen van methode 1

• ✅ Snelle installatie: 10-15 minuten, geen fysieke bekabeling
• ✅ Geen ingrepen aan de omvormer: geen demontage, geen elektrisch risico
• ✅ Vrije COM-poort: de fysieke RS485-poort blijft beschikbaar voor een externe meter (Chint DTSU666) of een geavanceerde BMS-batterijregeling
• ✅ Werkt via wifi: ideaal als de omvormer in de garage staat en de domotica-box op kantoor, zonder dat er een ethernetkabel hoeft te worden aangelegd
• ✅ Kan samen met Solarman worden gebruikt: de Stick Logger blijft gegevens naar de cloud sturen — u behoudt de officiële mobiele app
• ✅ Geen aanschaf van apparatuur: alles gebeurt via software op bestaande apparatuur

Beperkingen en voorzorgsmaatregelen

• ⚠️ Afhankelijkheid van de Stick Logger: als de wifi-dongle crasht, opnieuw opstart of de netwerkverbinding verliest, wordt de MQTT-stroom onderbroken totdat de verbinding weer is hersteld
• ⚠️ Vertraging van 5-10 seconden: de Modbus-opvraging via TCP zorgt voor een kleine vertraging — perfect voor monitoring, maar beperkt voor realtime aansturing met dynamische tarieven
• ⚠️ Alleen-lezen op bepaalde firmwareversies: de meeste Stick Loggers staan het schrijven van registers via poort 8899 niet toe — het is onmogelijk om de modus van de omvormer (TOU, Backup, Self-Use) te wijzigen via MQTT
• ⚠️ Recente Solarman V5-firmware: bij de series 2024-2025 vereisen sommige firmwareversies een eigen handshake — de deye-inverter-mqtt-bridge ondersteunt dit protocol door DEYE_LOGGER_PROTOCOL: solarman_v5 in te stellen
• ⚠️ Alleen 2,4 GHz wifi: de Stick Logger ziet geen 5 GHz-netwerken — als uw mesh-box (Fritz!, Orbi, Deco) 2,4 en 5 GHz onder één SSID combineert, forceer dan tijdelijk een aparte 2,4 GHz SSID voor het koppelen

Gepubliceerde MQTT-topics

Dit zijn de belangrijkste topics die door deye-inverter-mqtt worden gegenereerd (configureerbaar voorvoegsel, hier solar/deye//):

In totaal zijn er ongeveer 80 meetwaarden beschikbaar, afhankelijk van het model (SG01/SG04/SG05), die volledig aanpasbaar zijn via het bestand metrics.yaml van het project.

Voorbeeld van een Docker-configuratie

Maak een docker-compose.yml -bestand aan op uw 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-adres van de Stick Logger op uw LAN
      DEYE_LOGGER_IP_ADDRESS: 192.168.1.50
      DEYE_LOGGER_PORT: 8899
      # Serienummer zichtbaar in de Solarman-app
      DEYE_LOGGER_SERIAL_NUMBER: 2712345678
      # Protocol: modbus_tcp (oud) of solarman_v5 (recente firmware)
      DEYE_LOGGER_PROTOCOL: modbus_tcp
      # Adres van uw Mosquitto-broker
      MQTT_HOST: 192.168.1.10
      MQTT_PORT: 1883
      MQTT_USERNAME: homeassistant
      MQTT_PASSWORD: uw_wachtwoord
      # Voorvoegsel van de gepubliceerde topics
      MQTT_TOPIC_PREFIX: solar/deye
      # Metriekgroep: deye_hybrid (SG04/SG05) of deye_sg01 (mono)
      DEYE_METRIC_GROUPS: deye_hybrid
      # Leesinterval (in seconden)
      DEYE_DATA_READ_INTERVAL: 60

Start de container: docker-compose up -d

Bekijk de logs: docker logs -f deye-bridge

Als alles correct is, ziet u regels van het type:

INFO - Successfully read 78 metrics from logger 2712345678
INFO - Published solar/deye/2712345678/ac/active_power: 4320
INFO - Published solar/deye/2712345678/battery/soc: 82

Methode 2 — Modbus RTU-gateway via fysieke RS485-poort

Werkingsprincipe

We omzeilen de Stick Logger volledig en sluiten rechtstreeks aan op de RS485-communicatiepoort van de omvormer (RJ45-connector of "RS485-A / RS485-B"-aansluitblok, afhankelijk van het Deye-model).

We installeren een Modbus RTU → Modbus TCP-gateway (RS485-naar-Ethernet-converter) die:

1. Fysiek wordt aangesloten op de COM-poort van de omvormer via een afgeschermde twisted pair-kabel (gekruiste RJ45-kabel of schroefklemmen)
2. Een Modbus/TCP-server op het lokale netwerk beschikbaar stelt (IP-adres van de gateway)
3. Dezelfde softwarebridge (of Node-RED met node-red-contrib-modbus) vraagt deze gateway op en publiceert opnieuw via MQTT

Schema van methode 2

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

Benodigde apparatuur

Bekabeling van de RS485-poort van Deye

Voor de modellen SG04LP3 en SG05LP3 (RJ45-connector met het label "RS485" of "BMS"):

Seriële instellingen: 9600 baud, 8 bits, geen pariteit, 1 stopbit (8N1), slave-ID = standaard 1 (controleer dit in het menu van de omvormer).

Voordelen van methode 2

• ✅ Volledige onafhankelijkheid van de Stick Logger: u kunt deze verwijderen, vervangen of parallel gebruiken voor Solarman — de lokale Modbus-stroom blijft doorgaan
• ✅ Lees- EN schrijftoegang: mogelijkheid om de omvormer via MQTT aan te sturen (wijziging van de modus TOU/Self-Use/Backup, doel-SOC-instelling, beperking van netinjectie…)
• ✅ Vertraging van 1-2 seconden: ideaal voor realtime aansturing (Dynamic ESS, gescripte piekafvlakking, reactie op dynamische SPOT-tarieven van Tibber of EPEX)
• ✅ Geen afhankelijkheid van cloud of wifi: werkt zelfs zonder internet, stabiel bekabeld lokaal netwerk
• ✅ Industriële betrouwbaarheid: de professionele Modbus-gateways (Moxa, Elfin) zijn ontworpen om jarenlang 24/7 te draaien zonder onderhoud

Beperkingen en voorzorgsmaatregelen

• ⚠️ Extra materiaal: aankoop van een gateway (25-80 €) en fysieke bekabeling op de omvormer
• ⚠️ Neemt de COM-poort in beslag: als de RS485-poort al wordt gebruikt door een externe Chint DTSU666-meter of een geavanceerde BMS-batterijregeling, moet er worden gemultiplexed (complexer, vereist een RS485-hub)
• ⚠️ Solarman-monitoring wordt uitgeschakeld als de Stick Logger is losgekoppeld: maar beide kunnen naast elkaar bestaan als de omvormer over twee RS485-poorten beschikt (zoals bij de recente SG05)
• ⚠️ Vereiste elektrische vaardigheden: RJ45-connectoren krimpen, A/B-signalen identificeren, afsluitweerstand activeren — niet geschikt als u nog nooit met RS485 hebt gewerkt
• ⚠️ Ingreep in de schakelkast: de omvormer moet spanningsloos zijn om de COM-poort veilig te kunnen aansluiten

Typische toepassingen van methode 2

Deze methode is bedoeld voor installateurs en gevorderde particulieren die verder willen gaan dan alleen monitoring:

• Dynamische regeling van het tweevoudige tarief (Wallonië, France Tempo): de batterijlading tijdens daluren forceren via Modbus-register
• Gescreepte piekafvlakking: de teruglevering naar het net beperken wanneer het contract een drempel oplegt (installaties > 10 kVA)
• Op maat gemaakte strategie voor eigen verbruik: automatisch schakelen tussen de modi Self-Use, TOU en Backup op basis van tijd/SOC/weer
• Integratie met ERP/industriële SCADA: monitoring van meerdere locaties met Modbus-rapportage naar bedrijfssoftware (Schneider, Siemens, ABB)
• Cloudonafhankelijkheid: off-grid installatie of geen afhankelijkheid van Solarman voor monitoring

Vergelijkingstabel: welke methode moet u kiezen?

Snelle beslissingsgids

In de praktijk is methode 1 perfect geschikt voor 90 % van de residentiële installaties (particulieren, kleine tertiaire bedrijven). Er is geen materiaal of bekabeling nodig en alle nuttige metingen worden weergegeven.

Methode 2 is onmisbaar wanneer men overgaat tot actieve regeling, typisch om te profiteren van dynamische tarieven in Wallonië (Tibber-, Mega-, Bolt-contract) of om piekafvlakking te industrialiseren op driefasige installaties > 10 kVA.

Integratie aan de domotica-kant

Zodra de MQTT-topics op uw Mosquitto-broker zijn gepubliceerd, heeft elk domotica-platform zijn eigen integratiemechanisme:

Domoticz

MQTT Auto Discover -plugin of MQTT Client Gateway: semi-automatische aanmaak van virtuele apparaten op basis van de topics. Configuratie in Instellingen → Hardware → Toevoegen → MQTT Client Gateway.

Home Assistant

Geïntegreerde Mosquitto-broker- add-on + mqtt-YAML-configuratie: in configuration.yaml, of gebruik van het auto-discovery-mechanisme via het voorvoegsel homeassistant/. De entiteiten worden automatisch aangemaakt in de Lovelace-interface.

Jeedom

jMQTT-plugin: toevoeging van de Mosquitto-broker, abonneren op de topics solar/deye/#, handmatig of automatisch aanmaken van de commando's info/action in de virtuele apparaten.

Node-RED

MQTT-in -standaard knooppunten om op topics te abonneren, function- knooppunt om JSON-payloads te parseren en op te maken, MQTT-out-knooppunt om opnieuw te publiceren of logboeken te schrijven (alleen methode 2).

Grafana + InfluxDB

Telegraf in MQTT-abonneemodus ([[inputs.mqtt_consumer]]), verzending naar InfluxDB-database, 100% aanpasbare dashboards in Grafana voor realtime monitoring en historische gegevens.

Compatibiliteit Stick Logger WiFi: modellen en firmware

Alle originele Deye WiFi Stick Loggers hebben poort TCP 8899, ongeacht het fysieke medium (WiFi 2,4 GHz of Ethernet RJ45):

Twee voorzorgsmaatregelen bij een WiFi-logger

1. Vast IP-adres (gereserveerd DHCP): reserveer op uw internetbox het MAC-adres van de Stick Logger om te voorkomen dat het IP-adres verandert na een herstart van de box (anders wijst de bridge nergens naar).
2. Een apart 2,4 GHz-netwerk of gescheiden van het 5 GHz-netwerk: de Stick Loggers zien de 5 GHz-SSID's niet. Als uw mesh-router (Fritz!Box, Orbi, Deco) 2,4 en 5 GHz onder één SSID combineert, moet u tijdelijk een aparte 2,4 GHz-SSID forceren voor de eerste koppeling.

Recente firmware Solarman V5 (2024-2025)

Op enkele partijen LSW-3 met firmware ≥ MW3_16_5406_1.90 is Deye begonnen met het filteren van poort 8899 door een eigen handshake (Solarman V5-protocol) te vereisen. Het project deye-inverter-mqtt ondersteunt dit: u hoeft alleen de omgevingsvariabele te configureren:

DEYE_LOGGER_PROTOCOL: solarman_v5

in plaats van modbus_tcp. Dit is functioneel transparant, u hoeft slechts twee regels in de configuratie aan te passen.

Veelgestelde vragen (FAQ)

Kan ik beide methoden tegelijkertijd gebruiken?

Ja, als uw Deye-omvormer over twee RS485-poorten beschikt (zoals bij de recente SG05). U behoudt de Stick Logger voor Solarman Cloud + MQTT via methode 1 en sluit een RS485-gateway aan op de tweede COM-poort voor de besturing (methode 2). Dit is de meest complete configuratie voor een tertiaire installatie of een installateur die zowel de mobiele client-app als de geavanceerde besturing wil.

Kan de WiFi Stick Logger vastlopen of de verbinding verliezen?

Ja, net als alle andere 2,4 GHz wifi-apparatuur uit het lagere segment. Veelvoorkomende oorzaken: herstarten van de internetbox (de logger heeft 1-2 minuten nodig om opnieuw verbinding te maken), interferentie (magnetron, Bluetooth), betonnen muur tussen omvormer en box, onstabiele firmware. Oplossing: vast IP-adres, wifi-repeater in de buurt, of overschakelen naar Ethernet met een PLC-adapter als RJ45-bekabeling niet mogelijk is.

Kan ik de Deye-omvormer via MQTT aansturen met methode 1?

Nee** op de meeste recente Stick Logger-firmware. Poort 8899 is alleen-lezen. Voor het schrijven van registers (moduswijziging, SOC-instelwaarde, injectiebeperking) moet u Methode 2 (RS485-gateway) gebruiken, die volledige Modbus-toegang biedt.

Werkt de bridge met de eenfasige Deye-omvormers (SG01, SG02)?

Ja, het project deye-inverter-mqtt is compatibel met alle series: SG01LP1 (eenfasig laagspanning), SG02LP1 (eenfasig 10 kW), SG04LP3 (driefasig), SG05LP1 (eenfasig multi-net), SG05LP3 (driefasig). U hoeft alleen maar de variabele DEYE_METRIC_GROUPS aan te passen aan uw model (deye_sg01, deye_sg04, deye_hybrid…).

Kan ik Home Assistant gebruiken met de bridge?

Absoluut. Home Assistant integreert Mosquitto standaard (officiële add-on). Zodra de bridge is geïnstalleerd, configureert u de MQTT-integratie in Home Assistant, en de entiteiten worden automatisch aangemaakt via auto-discovery als u het voorvoegsel homeassistant/ in deye-inverter-mqtt activeert.

Wat is het stroomverbruik van de bridge?

Een Raspberry Pi 3 of 4 verbruikt ongeveer 2-5 W in ruststand; de Docker-container deye-inverter-mqtt voegt gemiddeld ~30 MB RAM en 0,1% CPU toe. Dit is verwaarloosbaar in vergelijking met de PV-productie (enkele kWh/jaar). Als u al een NAS of een domoticaserver heeft die 24/7 draait, verbruikt de bridge vrijwel niets extra.

Conclusie: Deye is niet gesloten, maar staat aan beide kanten open

De Deye-omvormer is geen gesloten systeem: hij stelt al zijn gegevens beschikbaar via standaard Modbus RTU, met twee bruikbare toegangspoorten — netwerk via Stick Logger (TCP 8899) en RS485 via een fysieke COM-poort. Deye heeft simpelweg nooit geïnvesteerd in een open domotica-ecosysteem: ze concentreren zich op Solarman Cloud en laten de open-sourcegemeenschap de leemte opvullen.

Voor 99% van de particuliere gebruikers is Methode 1 (TCP 8899-bridge + Mosquitto) de juiste oplossing: geen hardware, geen bekabeling, uitgebreide MQTT-topics op uw broker binnen 10 minuten. We houden Solarman parallel in gebruik voor de mobiele app en de fabrieksgarantie.

Voor liefhebbers en installateurs die willen sturen en niet alleen observeren — om alles uit een Tibber-contract, Mega-contract of een Wallonië 2026-tarief met twee tariefperiodes te halen — is Methode 2 (RS485-gateway) onmisbaar. Reken op een middagje integratie, € 50 aan hardware en volledige controle over uw energie-installatie.

In beide gevallen, zodra de gegevens in Mosquitto staan, bepaalt uw domoticasysteem wat ermee gebeurt: realtime dashboard, automatiseringen op basis van SOC-drempels, op maat gemaakte strategieën voor eigenverbruik, beheer van daluren, gescripte piekafvlakking. De Deye wordt weer wat hij in wezen is — een gestandaardiseerde industriële Modbus-controller — en niet langer een Chinese black box.

“We hebben 12 driefasige Deye SUN-12K-omvormers geïntegreerd voor een datacenter in Luik. De Solarman-monitoring voor consumenten volstond niet voor de SCADA-bewaking. Dankzij de Moxa RS485-gateways en de Modbus/MQTT-integratie konden we alle meetwaarden doorsturen naar ons EMS en de piekafvlakking in realtime aansturen. De latentie van 1 seconde maakt het verschil wanneer we moeten reageren op een verbruikspiek.” — Jean-Marc D., installateur in de tertiaire sector, Wallonië

Wattuneed SPRL
Rue Henripré 12, 4821 Andrimont, België
Tel.: +32 87 45 00 34 – info@wattuneed.com
www.wattuneed.com | Technische ondersteuning