Home Assistant MQTT mit Victron GX verbinden: Die N/R-MQTT-Bridge einrichten

Aktualisiert am 26. September 2026 (Clevr Victron 2.1.0-dev7): Frühere Fassungen behaupteten, die Integration sende Victron-Keepalives automatisch. Das tut sie nicht. Die Integration hört nur zu. Sie benötigen genau einen periodischen Sender pro GX der etwa alle 30 Sekunden eine vollständige Veröffentlichung anfordert — siehe Schritt 8. Wenn Sie 2.1.0-dev5 mit von Home Assistant verwaltetem Keepalive eingerichtet haben, fügen Sie den Sender hinzu vor dem Upgrade.

Die Clevr-Victron-Integration für Home Assistant liest Victron- und Fronius-Daten per MQTT.

Sie baut keine eigene MQTT-Verbindung zum Cerbo GX oder anderen GX-Geräten auf, sondern nutzt die bereits eingerichtete Home-Assistant-MQTT-Integration.

Dafür muss der Home-Assistant-Broker zwei Dinge können:

den Victron- N/ Meldungsbaum vom GX empfangenund die R/ Keepalive- oder Leseanfragen an den GX zurückleiten, damit ein periodischer Sender die GX-Datenveröffentlichung aufrechterhält.

Die Clevr-Integration selbst hört nur zu. Sie sendet weder R/ Anfragen noch W/ Schreibbefehle und ändert daher keine Victron-Einstellungen per MQTT.

Diese Anleitung zeigt die Einrichtung dieser Verbindung.

So funktioniert die MQTT-Verbindung

Eine typische Clevr-Installation sieht so aus:

             Victron GX
          Cerbo GX / Venus OS
                  │
                  │  N/<portal-id>/...
                  │  Victron measurements
                  ▼
       ┌─────────────────────┐
       │ Home Assistant      │
       │ Mosquitto Broker    │
       │                     │
       │ victron/N/...       │
       │ victron/R/...       │
       └─────────────────────┘
                  │
                  │ Home Assistant MQTT integration
                  ▼
       ┌─────────────────────┐
       │ Clevr Victron       │
       │ Integration         │
       └─────────────────────┘
                  │
                  ▼
        Home Assistant sensors

Es gibt auch Datenverkehr in Gegenrichtung:

Periodic sender (one per GX, e.g. a Home Assistant automation)
     │
     │ victron/R/<portal-id>/keepalive
     ▼
Mosquitto Bridge
     │
     │ R/<portal-id>/keepalive
     ▼
Victron GX

Die victron/ Teil in diesem Beispiel ist ein lokales Bridge-Präfix. Die Themen auf dem GX selbst beginnen weiterhin direkt mit N/ und R/.

Victrons aktuelle MQTT-Implementierung verwendet N/ für Meldungen, R/ für Leseanfragen und W/ für Anfragen, die D-Bus-Werte verändern können.

Für Clevr benötigen wir nur:

MQTT-Namensraum	Richtung	Zweck
`N/`	GX → Home Assistant	Messwerte und Geräteinformationen
`R/`	Home Assistant → GX	Lese- und Keepalive-Anfragen
`W/`	Nicht weitergeleitet	Victron-Einstellungsänderungen — für Clevr nicht nötig

Diese Trennung ist beabsichtigt.

Warum eine MQTT-Bridge?

Viele Home-Assistant-Installationen nutzen MQTT bereits für ESPHome, Zigbee-Gateways, Stromzähler, Sensoren oder andere Automationssysteme.

Dann sollte Home Assistant seinen normalen Broker weiterverwenden.

Statt Home Assistant auf den GX-Broker umzustellen, verbinden wir beide Broker über eine Mosquitto-Bridge.

Das Ergebnis ist einfach:

GX topic:

N/abcdef123456/system/0/Ac/Grid/L1/Power

becomes in Home Assistant:

victron/N/abcdef123456/system/0/Ac/Grid/L1/Power

In Gegenrichtung:

Home Assistant publishes:

victron/R/abcdef123456/keepalive

GX receives:

R/abcdef123456/keepalive

Mosquitto unterstützt genau diese Themenzuordnung mit lokalen und entfernten Präfixen.

Schrittweise Installation

MQTT-Zugriff am Victron GX aktivieren.
Der GX muss MQTT-Verbindungen aus dem lokalen Netzwerk erlauben.

Modernes Venus OS nutzt FlashMQ. Laut Victron ist der GX-Broker auf TCP-Port 1883 und/oder 8883, je nach Netzwerksicherheitskonfiguration des Geräts.

Prüfen Sie MQTT und lokalen Netzwerkzugriff am Cerbo GX oder anderen GX-Gerät.

Notieren Sie die GX-IP-Adresse. Eine DHCP-Reservierung oder statische IP wird dringend empfohlen, damit sie sich nicht unerwartet ändert.

Sie benötigen außerdem die VRM Portal ID des GX-Geräts.

Victron identifiziert jede MQTT-Anlage anhand dieser Portal ID, etwa:
```
N/abcdef123456/system/0/Ac/Grid/L1/Power
```
In diesem Beispiel:
```
abcdef123456
```
ist die Portal ID.

Laut Victron finden Sie die Portal ID in den VRM-Einstellungen des GX.
Mosquitto-Broker in Home Assistant installieren.
Nutzen Sie bereits MQTT, können Sie dies meist überspringen.

Öffnen Sie in Home Assistant OS:

Einstellungen → Apps → App installieren

und installieren Sie:

Mosquitto-Broker

Starten Sie nach der Installation die Mosquitto-App.

Home Assistant empfiehlt den offiziellen Mosquitto-Broker als einfachste lokale MQTT-Lösung. Die MQTT-Integration erkennt ihn normalerweise automatisch.

Prüfen Sie anschließend:

Einstellungen → Geräte & Dienste → MQTT

Die MQTT-Integration sollte verbunden sein.

Ein separater MQTT-Server wird ebenfalls unterstützt. Entscheidend ist, dass Home Assistants MQTT-Integration denselben Broker nutzt.
Eigene Mosquitto-Konfigurationsdateien aktivieren.
Öffnen Sie die Mosquitto-Broker App-Konfiguration.

Eigene Konfiguration aktivieren:
```
customize:
  active: true
  folder: mosquitto
```
Die offizielle App liest anschließend zusätzliche .conf Dateien aus:
```
/share/mosquitto/
```
Diesen Mechanismus stellt die offizielle Mosquitto-App bereit.

Victron-Bridge erstellen.

Erstellen Sie:

/share/mosquitto/victron.conf

Empfohlene Konfiguration:

connection victron-gx
address 192.168.1.50:1883

start_type automatic
try_private false
notifications false
cleansession true

topic N/YOUR_PORTAL_ID/# in 0 victron/ ""
topic R/YOUR_PORTAL_ID/# out 0 victron/ ""

Ersetzen Sie:

192.168.1.50

durch die IP-Adresse Ihres GX.

Ersetzen Sie:

YOUR_PORTAL_ID

durch die tatsächliche Portal ID Ihrer GX-Anlage.

Beispielsweise:

connection victron-gx
address 192.168.1.50:1883

start_type automatic
try_private false
notifications false
cleansession true

topic N/abcdef123456/# in 0 victron/ ""
topic R/abcdef123456/# out 0 victron/ ""

Die zwei topic Regeln sind entscheidend.

Diese Regel:

topic N/abcdef123456/# in 0 victron/ ""

abonniert diesen Baum auf dem GX:

N/abcdef123456/#

und stellt ihn im Home-Assistant-Broker bereit unter:

victron/N/abcdef123456/#

Die zweite Regel:

topic R/abcdef123456/# out 0 victron/ ""

macht das Gegenteil für Leseanfragen.

Eine lokal veröffentlichte Nachricht an:

victron/R/abcdef123456/keepalive

wird an den GX gesendet als:

R/abcdef123456/keepalive

Beachten Sie, dass absichtlich keine W/ Bridge-Regel vorhanden ist.

Mosquitto-Broker neu starten.
Starten Sie die Mosquitto-App nach Erstellung oder Änderung von victron.conf.

Prüfen Sie nach dem Start das Protokoll.

Es sollten keine wiederholten Verbindungsfehler für die victron-gx Bridge erscheinen.

Falls der GX keine Verbindungen auf Port 1883akzeptiert, prüfen Sie seine Netzwerksicherheit. Aktuelles Venus OS kann MQTT auf Port 8883 mit SSL/TLS anbieten, abhängig vom gewählten Sicherheitsprofil.

Verringern Sie nicht die Sicherheit, nur damit das Beispiel funktioniert. Unterstützt Ihr GX ausschließlich sicheres MQTT, konfigurieren Sie stattdessen die TLS-Verbindung der Bridge.
Testen Sie die N/ Richtung.
Öffnen Sie in Home Assistant:

Einstellungen → Geräte & Dienste → MQTT → Konfigurieren

Suchen Sie Auf ein Thema hören.

Geben Sie ein:
```
victron/N/YOUR_PORTAL_ID/#
```
und starten Sie das Zuhören.

Anfangs sehen Sie möglicherweise wenig oder nichts.

Das ist normal.

Modernes Venus OS veröffentlicht den vollständigen MQTT-Baum nicht mehr als gespeicherte Nachrichten. Verbundene Clients müssen per Victron-Keepalive eine Aktualisierung anfordern.
Testen Sie die R/ Richtung mit einem Keepalive.
Lassen Sie den Themenempfänger laufen.

Veröffentlichen Sie auf der MQTT-Konfigurationsseite ein Paket an:
```
victron/R/YOUR_PORTAL_ID/keepalive
```
mit leerer Nutzlast.

Die Bridge entfernt das victron/ Präfix und der GX erhält:
```
R/YOUR_PORTAL_ID/keepalive
```
Der GX sollte nun seine aktuellen Daten veröffentlichen.

In Home Assistant sollten Nachrichten erscheinen wie:
```
victron/N/YOUR_PORTAL_ID/system/0/...
```
```
victron/N/YOUR_PORTAL_ID/solarcharger/...
```
```
victron/N/YOUR_PORTAL_ID/pvinverter/...
```
und weitere installierte Geräte.

Am Ende einer vollständigen Aktualisierung veröffentlichen neuere Venus-OS-Versionen außerdem:
```
N/YOUR_PORTAL_ID/full_publish_completed
```
Victron empfiehlt ausdrücklich den R/<portal-id>/keepalive Mechanismus zur Anforderung des aktuellen MQTT-Baums.
Genau einen periodischen Sender für vollständige Veröffentlichungen einrichten.
Der GX veröffentlicht seinen vollständigen MQTT-Baum nur auf Anfrage. Integration und Panel fragen nie an: Ein anderer Dienst am Standort muss das übernehmen.

Konfigurieren genau einen Sender pro GX der eine dieser Anfragen sendet etwa alle 30 Sekunden:
```
victron/R/YOUR_PORTAL_ID/keepalive            (empty payload)
```
oder eine Leseanfrage:
```
victron/R/YOUR_PORTAL_ID/system/0/Serial     (empty payload)
```
Beide lösen die vollständige Veröffentlichung aus, endend mit N/YOUR_PORTAL_ID/full_publish_completed.

Prüfen Sie zuerst, ob bereits ein Sender vorhanden ist. Node-RED, andere Victron-Integrationen oder vorhandene Automationen senden oft bereits Keepalives. Hören Sie auf victron/R/YOUR_PORTAL_ID/# eine Minute lang: Kommen regelmäßig Anfragen, behalten Sie diesen Sender und ergänzen keinen zweiten. Zwei Sender verdoppeln unnötig die vollständigen Veröffentlichungen.

Fehlt ein Sender, ist eine Home-Assistant-Automation am einfachsten. Erstellen Sie eine Automation, wechseln Sie zu In YAML bearbeiten und fügen Sie Folgendes mit Ihrer Portal ID und Ihrem Präfix ein:
```
alias: Victron GX full republish
description: The only periodic sender for this GX. Do not add a second one.
triggers:
  - trigger: time_pattern
    seconds: "/30"
actions:
  - action: mqtt.publish
    data:
      topic: victron/R/abcdef123456/keepalive
      payload: ""
mode: single
```
Verwenden Sie nicht die suppress-republish Keepalive-Option (eine Keepalive-Nutzlast wie {"keepalive-options": ["suppress-republish"]}). Sie verhindert, dass der GX full_publish_completedsendet, was Clevr benötigt. Unveränderte Panelwerte können dadurch nach 65 Sekunden veralten.

Warum 30 Sekunden? GX akzeptiert bis zu 60 Sekunden. 30 Sekunden erlauben zwei vollständige Veröffentlichungen innerhalb des 130-Sekunden-Scans und halten Werte sicher innerhalb der 65-Sekunden-Aktualitätsgrenze.

Prüfen Sie das Ergebnis durch Zuhören auf victron/N/YOUR_PORTAL_ID/full_publish_completed. Etwa alle 30 Sekunden sollte eine neue Nachricht eintreffen.
Clevr-Victron-Integration konfigurieren.
Sobald die Bridge funktioniert, installieren oder konfigurieren Sie die Clevr Victron Panel Integration.

Bei der Abfrage von:

MQTT-Bridge-Präfix

geben Sie ein:
```
victron/
```
Bei der Abfrage von:

GX Portal ID

geben Sie Ihre Portal ID ein:
```
abcdef123456
```
Clevr sucht deshalb unter:
```
victron/N/abcdef123456/
```
Sie sendet nichts an victron/R/abcdef123456/: Die Anfragen dort stammen vom periodischen Sender.

Die Erkennung wartet bis zu 130 Sekunden auf zwei vollständige Veröffentlichungen. Daher muss der Sender aus Schritt 8 vor dem Hinzufügen der Integration laufen.

Das MQTT-Präfix verstehen

Das Clevr-Präfix muss dem entsprechen, was vorhanden ist auf dem Home-Assistant-MQTT-Broker, nicht zwingend dem GX selbst.

Beispielsweise:

In Home Assistant sichtbare Themen	Clevr-MQTT-Präfix
`victron/N/<portal>/...`	`victron/`
`gx/N/<portal>/...`	`gx/`
`energy/victron/N/<portal>/...`	`energy/victron/`
`N/<portal>/...`	Präfix leer lassen

Für die hier gezeigte Bridge verwenden Sie:

victron/

Wenn Home Assistant direkt am GX-Broker Themen empfängt, die beginnen mit:

N/<portal-id>/

lassen Sie das Clevr-Präfix leer.

Warum das Keepalive wichtig ist

Victrons aktuelle MQTT-Implementierung nutzt keine gespeicherten Nachrichten für den vollständigen Gerätebaum.

Anwendungen abonnieren stattdessen den N/ Baum und fordern Daten an über:

R/<portal-id>/keepalive

Der GX veröffentlicht daraufhin die verfügbaren Daten erneut. Victron nennt 60 Sekunden Keepalive-Timeout und empfiehlt regelmäßige Aktualisierung bei aktiver MQTT-Anwendung.

Die Clevr-Integration sendet keine Keepalives. Sie hört nur den GX-Daten zu. Seit 2.1.0-dev7 sendet sie keinerlei R/ Anfragen, weder bei der Einrichtung noch im Betrieb.

Sie benötigen daher genau einen periodischen Sender pro GX, etwa alle 30 Sekunden, wie beschrieben in Schritt 8. Ohne Sender findet der Scan keine vollständige Veröffentlichung und Panelwerte veralten. Bei mehreren Sendern veröffentlicht der GX seinen Baum unnötig oft.

Clevr schreibt keine Einstellungen in den GX

Diese Unterscheidung ist wichtig.

Victron MQTT verwendet:

N/

für Meldungen,

R/

für Lesezugriffe,

und:

W/

für Schreibanfragen. Laut Victron können W/ Anfragen D-Bus-Werte und damit Betriebseinstellungen ändern.

Die Clevr-Victron-Integration benötigt nicht den W/ Namensraum.

Unsere empfohlene Mosquitto-Konfiguration enthält deshalb:

topic N/YOUR_PORTAL_ID/# in 0 victron/ ""
topic R/YOUR_PORTAL_ID/# out 0 victron/ ""

enthält aber bewusst nicht Folgendes:

topic W/# out

Das bietet eine zusätzliche Schutzschicht direkt an der MQTT-Bridge.

Selbst wenn ein anderer Client versehentlich veröffentlicht an:

victron/W/...

auf dem Home-Assistant-Broker, erlaubt keine Regel der gezeigten Bridge die Weiterleitung zum GX.

Die Victron-Verbindung ist bei Clevr daher ausgelegt auf Überwachung und Leseanfragen, nicht die Steuerung von GX-Einstellungen.

Fehlersuche

Problem	Was prüfen?
MQTT-Integration nicht verfügbar	Prüfen, ob der Mosquitto-Broker läuft
Bridge verbindet nicht	GX-IP, MQTT-Zugriff und vom Sicherheitsprofil erlaubten Port prüfen
Keine `victron/N/...` Themen sichtbar	Senden Sie ein `R/<portal>/keepalive`; moderne GX-Daten bleiben nicht einfach unbegrenzt gespeichert
`N/` Daten kommen an, aber Clevr meldet „Keine aktuellen GX-Daten“	Clevr Portal ID und MQTT-Präfix prüfen
Keepalive ohne Antwort	Prüfen, ob die `R/` Bridge-Regel existiert und von Home Assistant zum GX zeigt
Themen beginnen mit `N/...` statt `victron/N/...`	Kein lokales Präfix vorhanden; Clevr-MQTT-Präfix leer lassen
Themen unter anderem Präfix	Vollständiges Präfix in Clevr eingeben
Port 1883 abgelehnt	GX-Netzwerksicherheit prüfen; eventuell ist sicheres MQTT auf Port 8883 nötig
Daten erscheinen kurz und stoppen	Kein periodischer Sender aktiv oder die `R/` Bridge-Regel leitet seine Anfragen nicht zum GX
Clevr meldet “Keine aktuellen GX-Daten” oder erkennt nur Teile	Prüfen, ob ein Sender etwa alle 30 Sekunden ein Keepalive sendet und `full_publish_completed` eintrifft; verwenden Sie nicht `suppress-republish`
Vollständige Veröffentlichungen häufiger als alle 30 Sekunden	Mehrere Sender aktiv, etwa Node-RED und HA-Automation; nur einen behalten

Das Endergebnis

Nach dieser Einrichtung sollte Home Assistant einen bidirektionalen schreibgeschützten MQTT-Datenweg zum Victron GX haben:

Victron GX
   │
   │ N/ notifications
   ▼
Mosquitto bridge
   │
   │ victron/N/...
   ▼
Home Assistant
(one periodic sender, ~30 s)
   │
   │ victron/R/... keepalive
   ▼
Mosquitto bridge
   │
   │ R/... keepalive
   ▼
Victron GX

Bewusst gibt es keinen entsprechenden Weg für:

W/

Wenn diese MQTT-Schicht läuft, installieren Sie die Clevr-Victron-Panel-Integration für Home Assistant. Sie nutzt die vorhandene MQTT-Verbindung, um Victron-System, MPPT-Regler, Netz- und Batteriegeräte sowie unterstützte AC-PV-Wechselrichter wie Fronius zu erkennen.

Keine weiteren MQTT-Zugangsdaten müssen in Clevr eingegeben werden.

Nächster Schritt: Integration installieren — siehe Victron GX und Fronius mit der Clevr-Victron-Integration an Home Assistant anbinden. Anschließend Ihr Clevr GX Panel konfigurieren.