Connect Home Assistant MQTT till en Victron GX: Konfigurera N/R MQTT Bridge

Uppdaterad 26 september 2026 (Clevr Victron 2.1.0-dev7): tidigare versioner av denna guide sa att Clevr-integrationen skickar Victron-konserveringstiden automatiskt. Det gör det inte. Integrationen lyssnar bara. Du behöver nu exakt en periodisk avsändare per GX som begär en fullständig återpublicering om var 30: e sekund — se Steg 8. Om du ställer in Clevr 2.1.0-dev5 med Home Assistant-managed keepalive, lägg till denna avsändare före Uppgradering.

och Clevr Victron integration för Home Assistant Läser Victron och Fronius-information via MQTT.

Det skapar inte en separat MQTT-anslutning till din Cerbo GX eller annan Victron GX-enhet. Istället använder den MQTT-integrering som redan är konfigurerad i Home Assistant.

För att detta ska fungera korrekt måste Home Assistants MQTT-mäklare kunna göra två saker:

ta emot Victron N/ anmälningsträd från GX-enhetenoch passerar R/ Hålla eller läsa förfrågningar tillbaka till GX-enhetenSå att en periodisk avsändare kan hålla GX publicera sina data.

Clevr-integrationen själv endast lyssnar. Den skickar inte R/ Förfrågningar och inga W/ Skriv kommandon och använd därför inte MQTT för att ändra inställningar på ditt Victron-system.

Denna guide visar hur man konfigurerar den anslutningen.

Hur MQTT-anslutningen fungerar

En typisk Clevr-installation ser ut så här:

             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

Det finns också trafik i motsatt riktning:

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

och victron/ del i detta exempel är en lokal brygga prefix. De verkliga ämnena på GX-enheten börjar fortfarande direkt med N/ och R/.

Victrons nuvarande MQTT implementering använder N/ för anmälningar, R/ för att läsa förfrågningar och W/ För förfrågningar som kan ändra D-Bus-värden.

För Clevr-integrationen behöver vi bara:

MQTT namnrymd	Riktning	syfte
`N/`	GX - Home Assistant	Mätningar och enhetsinformation
`R/`	Home Assistant - GX	Reads och keepalive requests
`W/`	Inte överbryggd	Victron inställning förändringar - inte krävs av Clevr

Denna separation är avsiktlig.

Varför använda en MQTT-bro?

Många Home Assistant-installationer använder redan MQTT för annan utrustning: ESPHome-enheter, Zigbee-gateways, kraftmätare, sensorer eller andra automationssystem.

I denna situation bör Home Assistant fortsätta använda sin vanliga MQTT-mäklare.

Istället för att byta Home Assistant för att använda GX-enheten som sin MQTT-mäklare ansluter vi de två mäklare med en Mosquitto bridge.

Resultatet är enkelt:

GX topic:

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

becomes in Home Assistant:

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

I den andra riktningen:

Home Assistant publishes:

victron/R/abcdef123456/keepalive

GX receives:

R/abcdef123456/keepalive

Mosquitto stöder exakt den här typen av ämnesomvandling med lokala och avlägsna prefix.

Steg-för-steg installation

MQTT-åtkomst på Victron GX-enheten.
Din GX-enhet måste tillåta MQTT-anslutningar från det lokala nätverket.

Modern Venus OS använder FlashMQ för sin lokala MQTT-tjänst. Victron dokumenterar GX MQTT-mäklaren som tillgänglig på TCP-port 1883 och/eller 8883beroende på enhetens nätverkssäkerhetskonfiguration.

Kontrollera MQTT och lokala nätverksåtkomstinställningar på din Cerbo GX eller annan GX-enhet.

Notera också GX-enhetens IP-adress. Vi rekommenderar starkt att du ger GX-enheten en DHCP-bokning eller statisk IP så att adressen inte oväntat ändras.

Du behöver också VRM Portal ID av GX-enheten.

Victron identifierar varje MQTT-installation med detta portal-ID, till exempel:
```
N/abcdef123456/system/0/Ac/Grid/L1/Power
```
I detta exempel:
```
abcdef123456
```
är Portal ID.

Victron dokumenterar Portal ID som tillgänglig från GX-enhetens VRM-inställningar.
Installera Mosquitto-mäklaren i Home Assistant.
Om du redan använder MQTT i Home Assistant kan du normalt hoppa över den här delen.

För Home Assistant OS, öppna:

Inställningar → Apps → Installera app

och installera:

Mosquitto mäklare

Starta Mosquitto-appen efter installationen.

Home Assistant rekommenderar sin officiella Mosquitto-mäklare som den enklaste lokala MQTT-inställningen. MQTT-integrationen kommer normalt att upptäcka mäklaren automatiskt.

Kontrollera sedan:

Inställningar → Enheter & tjänster → MQTT

MQTT-integrationen ska visas som ansluten.

Om du använder en separat MQTT-server istället för Home Assistants Mosquitto-app stöds den också. Det viktiga kravet är att detta är samma mäklare som används av Home Assistants MQTT-integration.
Aktivera anpassade Mosquitto konfigurationsfiler.
Öppna öppna Mosquitto mäklare Appkonfiguration.

Aktivera anpassad konfiguration:
```
customize:
  active: true
  folder: mosquitto
```
Home Assistants officiella Mosquitto-app kommer sedan att läsa ytterligare .conf filer från:
```
/share/mosquitto/
```
Denna anpassade konfigurationsmekanism tillhandahålls av den officiella Mosquitto-appen.

Skapa Victron bron.

Skapa:

/share/mosquitto/victron.conf

En rekommenderad konfiguration är:

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/ ""

Ersätt:

192.168.1.50

med IP-adressen för din GX-enhet.

Ersätt:

YOUR_PORTAL_ID

med det faktiska Portal ID för GX-installationen.

Till exempel:

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/ ""

De två topic Reglerna är den viktiga delen.

Denna regel:

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

prenumererar på detta träd på GX:

N/abcdef123456/#

och placerar den i Home Assistant mäklare under:

victron/N/abcdef123456/#

Den andra regeln:

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

Tvärtom för att läsa förfrågningar.

Ett meddelande publicerat lokalt till:

victron/R/abcdef123456/keepalive

skickas till GX som:

R/abcdef123456/keepalive

Lägg märke till att det medvetet finns Ingen W/ Bridge regel.

Starta Mosquitto mäklare.
Starta Mosquitto-appen efter att ha skapat eller ändrat victron.conf.

Kontrollera sin logga efter start.

Du bör inte se upprepade anslutningsfel för victron-gx Bro.

Om GX-enheten inte accepterar anslutningar på port 1883Kontrollera dess lokala nätverkssäkerhetskonfiguration. Nuvarande Venus OS-installationer kan exponera MQTT på porten 8883 använda SSL/TLS istället, beroende på den valda säkerhetsprofilen.

Minska inte säkerheten för en installation bara för att göra exemplet konfiguration arbete. Om din GX är konfigurerad för säker MQTT bara, konfigurera bron för dess TLS-anslutning istället.
Testa testet N/ riktning.
In Home Assistent öppen:

Inställningar → Enheter & tjänster → MQTT → Konfigurera

Hitta Lyssna på ett ämne.

Enter:
```
victron/N/YOUR_PORTAL_ID/#
```
Börja lyssna.

Du kan först se väldigt lite eller ingenting.

Detta är normalt.

Modern Venus OS publicerar inte längre hela MQTT-trädet som behållna meddelanden. En klient som ansluter måste begära en uppfriskning med hjälp av ett Victron-konservativ.
Testa testet R/ Riktning med ett keepalive.
Håll ämnet lyssnaren igång.

På MQTT-konfigurationssidan publicerar du ett MQTT-paket till:
```
victron/R/YOUR_PORTAL_ID/keepalive
```
med en tom nyttolast.

Bron tar bort victron/ Prefix och GX får:
```
R/YOUR_PORTAL_ID/keepalive
```
GX bör sedan publicera sina nuvarande MQTT-data.

Inom hembiträde bör du börja se meddelanden som:
```
victron/N/YOUR_PORTAL_ID/system/0/...
```
```
victron/N/YOUR_PORTAL_ID/solarcharger/...
```
```
victron/N/YOUR_PORTAL_ID/pvinverter/...
```
och andra enheter installerade på ditt system.

I slutet av en fullständig uppfriskning publicerar även de senaste Venus OS-versionerna:
```
N/YOUR_PORTAL_ID/full_publish_completed
```
Victron rekommenderar specifikt R/<portal-id>/keepalive mekanism för att begära det nuvarande MQTT-trädet.
Ställ in exakt en periodisk full-republicera avsändare.
GX publicerar bara sitt kompletta MQTT-träd när det uppmanas. Clevr-integrationen och Clevr-panelen frågar aldrig: något annat på din webbplats måste göra det.

Konfigurera exakt en avsändare per GX som publicerar en av dessa förfrågningar ca 30 sekunder:
```
victron/R/YOUR_PORTAL_ID/keepalive            (empty payload)
```
eller en läsförfrågan:
```
victron/R/YOUR_PORTAL_ID/system/0/Serial     (empty payload)
```
Båda gör att GX publicerar sitt fulla träd och slutar med N/YOUR_PORTAL_ID/full_publish_completed.

Kontrollera först om din webbplats redan har en. Node-RED-flöden, andra Victron-integrationer eller en befintlig Home Assistant-automation skickar ofta ett konsekvent. Lyssna på victron/R/YOUR_PORTAL_ID/# i en minut: om förfrågningar anländer regelbundet, hålla den avsändaren och inte lägga till en annan. En andra avsändare gör att GX publicerar hela sitt träd dubbelt så ofta, utan någon nytta.

Om det inte finns någon, är en Home Assistant automation den enklaste avsändaren. Skapa en ny automation, byta till Redigera i YAML och pasta (med ditt eget portal-ID och prefix):
```
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
```
Använd inte suppress-republish Keepalive option (ett betalt av behållande som {"keepalive-options": ["suppress-republish"]}). Det stoppar GX-sändningen full_publish_completed, som Clevr-inställningen behöver, och panelvärden som inte ändras kan stjäla efter 65 sekunder.

Varför 30 sekunder: GX accepterar ett kontinuerligt intervall på upp till 60 sekunder, men 30 sekunder låter installationsskanningen se två kompletta publikationer inom sin 130 sekunders gräns och håller panelvärden väl inne i sin 65 sekunders friskhetsgräns.

Kontrollera resultatet: lyssna på victron/N/YOUR_PORTAL_ID/full_publish_completed. Ett nytt meddelande ska komma fram ungefär var 30:e sekund.
Konfigurera Clevr Victron integration.
När bron fungerar, installera eller konfigurera bron Clevr Victron Panel integration.

När det frågar efter:

MQTT bridge prefix

Ange:
```
victron/
```
När det frågar efter:

GX Portal ID

Ange ditt faktiska portal-ID:
```
abcdef123456
```
Clevr kommer därför att se under:
```
victron/N/abcdef123456/
```
Det skickar inte något till victron/R/abcdef123456/Förfrågningarna som kommer från din periodiska avsändare.

Inställningsskanningen väntar upp till 130 sekunder för två kompletta GX-publikationer, så den periodiska avsändaren från steg 8 måste redan vara igång när du lägger till integrationen.

Förstå MQTT Prefix

Prefixet som anges i Clevr-konfigurationen måste matcha vad som finns på Home Assistent MQTT mäklareInte nödvändigtvis vad som finns på GX själv.

Till exempel:

Ämnen synliga i Home Assistant	Clevr MQTT prefix
`victron/N/<portal>/...`	`victron/`
`gx/N/<portal>/...`	`gx/`
`energy/victron/N/<portal>/...`	`energy/victron/`
`N/<portal>/...`	lämna prefix tom

För den brokonfiguration som visas i denna artikel, använd:

victron/

Om Home Assistant ansluter direkt till GX MQTT-mäklaren och ser ämnen som börjar direkt med:

N/<portal-id>/

Clevr prefixet ska lämnas tomt.

Varför Keepalivet är viktigt

Victrons nuvarande MQTT-implementering är inte beroende av behållna meddelanden för komplett enhetsträd.

Istället prenumererar applikationer på N/ träd och begär sedan aktuella data med hjälp av:

R/<portal-id>/keepalive

GX svarar genom att publicera sina tillgängliga data igen. Victron dokumenterar en 60-sekunders tidsperiod och rekommenderar regelbundet uppdatera den medan en MQTT-applikation är aktiv.

Integrationen av Clevr skickar inte lagerhållningar. Det lyssnar bara på de data som din GX publicerar. Sedan 2.1.0-dev7 skickar den inte R/ Förfrågningar alls, under installation eller vid drifttid.

Du behöver därför exakt en periodisk avsändare per GXca 30 sekunder, som beskrivs i Steg 8. Med ingen, installationsskanningen finner ingen komplett publikation och panelens värderingar går förföljda. Med två eller flera publicerar GX hela sitt träd oftare än nödvändigt.

Clevr skriver inte inställningar till GX

Denna distinktion är viktig.

Victron MQTT använder:

N/

för anmälningar,

R/

för läsningar,

och:

W/

för att skriva förfrågningar. Victrons dokumentation visar att W/ Förfrågningar kan ändra D-Bus-värden och därför ändra operativa inställningar.

Clevr Victron integration gör Inte inte behöver W/ Namnspace.

Vår rekommenderade Mosquitto-konfiguration innehåller följaktligen:

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

men medvetet gör Inte inte innehåller:

topic W/# out

Detta ger ytterligare ett skyddslager på själva MQTT-bron.

Även om en annan klient av misstag publicerar:

victron/W/...

Till Home Assistant mäklare, bron konfiguration som visas här har ingen regel som tillåter det meddelandet att nå GX-enheten.

För Clevr-integrationen är Victron-anslutningen därför utformad runt Övervaka och läsa förfrågningar, inte kontroll över GX-inställningar.

Felsökning

Problemproblem	Vad man ska kontrollera
MQTT integration är otillgänglig	Kontrollera att Home Assistant Mosquitto mäklare körs
Bridge kommer inte att ansluta	Verifiera GX IP-adress, MQTT-åtkomst och den port som tillåts av säkerhetsprofilen GX
Inget nej `victron/N/...` ämnen visas	Skicka en `R/<portal>/keepalive`Moderna GX MQTT-data behålls inte bara för evigt
`N/` data kommer men Clevr rapporterar "Inga färska GX-data"	Kolla Clevr Portal ID och MQTT prefix
Keepalive producerar inget svar	Kontrollera att `R/` bridge regel är närvarande och punkter från Home Assistant till GX
Ämnen börjar med `N/...` snarare än `victron/N/...`	Anslutningen har inget lokalt prefix; lämna Clevr MQTT prefixet tomt
Ämnen visas under ett annat prefix	Ange det kompletta prefixet i Clevr-inställningen
Port 1883 vägras	Kontrollera GX lokala nätverkssäkerhetsprofil; installationen kan kräva säker MQTT på port 8883
Data visas kort och slutar sedan	Ingen periodisk avsändare körs, eller `R/` bronstyre överför inte sina begäranden till GX
Clevr installationsrapporter “Inga nya GX-data” eller finner endast en del av systemet	Kontrollera att en avsändare publicerar ett underhållande ca var 30: e sekund och att `full_publish_completed` anländer; Använd inte `suppress-republish`
Full publicering anländer oftare än var 30:e sekund	Två eller flera avsändare är aktiva (till exempel automatisering av Node-RED och Home Assistant).

Det slutliga resultatet

När denna konfiguration är klar, bör Home Assistant ha en dubbelriktad Läs-bara MQTT-banan till Victron GX:

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

Det finns avsiktligt ingen motsvarande väg för:

W/

Med detta MQTT lager fungerar, kan du fortsätta att installera Clevr Victron Panel Integration För Home Assistant. Integrationen kommer att använda Home Assistants befintliga MQTT-anslutning för att upptäcka ditt Victron-system, MPPT solladdare, rutnät och batterienheter och stödda AC PV-omriktare som Fronius.

Inga ytterligare MQTT-uppgifter måste ingå i Clevr Home Assistant integration.

Nästa steg: installera själva integrationen — se Anslut Victron GX och Fronius till Home Assistant med Clevr Victron Integration. Sedan dess, Konfigurera din Clevr GX Panel.