ENPLDEPT
Flash
Alle Docs
Modbus · Beta

Dein Wechselrichter am Node — über RS485, nur lesend.

Firmware 1.14 kann einen Wechselrichter oder Energiezähler über Modbus RTU auslesen und die Werte zu Node-Entitäten machen, und sie arbeitet als Modbus-TCP-Brücke, damit Home Assistant mit demselben RS485-Bus spricht. Beides ist standardmäßig aus und läuft im LAN ohne Internet.

Was es macht

Zwei unabhängige Funktionen, beide standardmäßig aus:

  • Register auslesen — der Node fragt alle 10 Sekunden bis zu 16 Register ab (FC03/FC04; u16, s16, u32, s32, f32; Wortreihenfolge; Skala; Einheit) und veröffentlicht sie als Entitäten own.mb_<name> oder als native Messwerte wie Netzleistung und Ladestand der Batterie. Sie erscheinen auf der Node-Karte in der App, in Home Assistant über die HACS-Integration und in der lokalen API des Nodes.
  • Modbus-TCP-Brücke auf Port 502 — Home Assistant (eingebaute Modbus-Integration), Node-RED oder SCADA verbinden sich per TCP mit dem Node und sprechen mit jedem Gerät am RS485-Bus: Wechselrichter, Zähler, Wärmepumpe, Lüftungsanlage. Lesefunktionen FC1–4 gehen immer durch, Schreiben erst nach dem Einschalten.

Firmware 1.14 ist im Netz ausgerollt (LoRa-Boards: 1.14-lora2); was sich in jeder Version geändert hat, steht im CHANGELOG.

Anschluss

Du brauchst ein RS485-Modul (zum Beispiel MAX485 oder ein Modul mit automatischer Richtungsumschaltung) zwischen Node und dem RS485/Modbus-Port des Wechselrichters (A an A, B an B, gemeinsame Masse, falls der Port eine hat).

EinstellungStandardFeld
RX-Pin16rx
TX-Pin17tx
DE/RE-Pinkeiner (Modul mit automatischer Richtung)de
Geschwindigkeit9600 Baud, 8N1baud, parity (N/E/O)
Modbus-Adresse des Geräts1slave

Geschwindigkeit 1200–115200, Parität keine, gerade oder ungerade. Ändere die Pins, wenn dein Board 16/17 anders belegt.

Einschalten

In der Beta-App (1.6.6 oder neuer) die Konfiguration des Nodes öffnen und Modbus RS485 wählen: Preset auswählen, Pins setzen und speichern. Die App spricht im LAN mit der PIN des Nodes.

Dasselbe über die lokale API des Nodes (IP und PIN ersetzen):

curl http://192.168.1.50/node/modbus
curl -X POST -H "Authorization: Bearer 123456" \
     -d '{"on":true,"preset":"deye1"}' http://192.168.1.50/node/modbus

GET /node/modbus liefert Konfiguration, Preset-Liste, letzte Werte und Zähler. POST /node/modbus (PIN nötig) nimmt die Felder aus der Tabelle oben plus on (Abfrage), bridge (TCP 502), write (Schreiben über die Brücke erlauben) und entweder preset oder eine eigene regs-Liste.

Presets

PresetGerätWerte
deye1Deye/Sunsynk 1-phasiger HybridLeistung PV1 und PV2, Netz-, Last- und Batterieleistung, Ladestand und Spannung der Batterie, Netzspannung und -frequenz, PV heute und gesamt, Wechselrichtertemperatur, Warn- und Fehlercodes
deye3Deye/Sunsynk 3-phasiger LV-Hybridderselbe Satz für die dreiphasigen Niedervolt-Modelle
sdmZähler Eastron SDM120 (1-phasig)Spannung, Strom, Leistung, Frequenz, Bezug und Einspeisung

Ein Preset ist nur eine fertige Registerliste: nach dem Laden kannst du sie bearbeiten oder durch eigene Register ersetzen (bis zu 16).

Home Assistant über die Brücke

Brücke einschalten ("bridge":true) und in Home Assistant einen Modbus-Hub auf den Node anlegen:

modbus:
  - name: inverter
    type: tcp
    host: 192.168.1.50
    port: 502

Der Node leitet jede TCP-Anfrage an den RS485-Bus weiter und gibt die Antwort zurück. Die Brücke hat Vorrang vor der eigenen Abfrage des Nodes, beides kann also gleichzeitig laufen.

Stand der Beta

  • Die Abfrage liest nur; der Node ändert nie Einstellungen des Wechselrichters, außer du erlaubst Schreiben in der Brücke.
  • Die Deye/Sunsynk-Karten sind noch nicht an einem echten Wechselrichter geprüft — vergleiche mit dem Display, besonders das Vorzeichen der Batterieleistung.
  • Willst du helfen? Im Testerprogramm gibt es ein Deye-Szenario: Tester.

Fragen, klare Antworten

Ist das fertig?

Nein, es ist eine Beta. Die Registerkarten für Deye/Sunsynk stammen aus der Herstellerdokumentation und wurden noch nicht an einem echten Wechselrichter geprüft. Vergleiche die Werte mit dem Display des Wechselrichters, bevor du dich darauf verlässt, und melde das Ergebnis im Testerprogramm.

Kann der Node Einstellungen des Wechselrichters ändern?

Nicht beim Auslesen: die Abfrage nutzt nur Lesefunktionen (FC03/FC04). Die TCP-Brücke lässt Schreibfunktionen (FC5/6/15/16) nur durch, wenn du „write“ selbst einschaltest; standardmäßig liest auch sie nur.

Braucht es Internet?

Nein. Die Konfiguration läuft über dein LAN mit der PIN des Nodes, Abfrage und Brücke laufen auf dem Node. Internet brauchst du nur, um die Werte unterwegs in der App oder auf der Karte zu sehen.

Welche Firmware brauche ich?

1.14 oder neuer (auf LoRa-Boards 1.14-lora2). Nodes aktualisieren sich selbst per OTA; die Version steht auf der Node-Karte in der App.

Aktualisiert: 2026-11-18