Forbind Home Assistant MQTT til en Victron GX: Indstil N / R MQTT-broen

Opdateret den 26. september 2026 (Clevr Victron 2.1.0-dev7): Tidligere versioner af denne guide sagde, at Clevr integration sender Victron holde sig i live automatisk. Det gør det ikke. Integrationen lytter kun. Du har nu brug for nøjagtigt én periodisk afsender pr. GX der anmoder om en fuld republicering omkring hver 30 sekunder — Se trin 8. Hvis du opretter Clevr 2.1.0-dev5 med Home Assistant- managed keeplive, tilføje denne afsender før opgradering.

Den Clevr Victron integration til Home Assistant læser Victron og Fronius information gennem MQTT.

Det skaber ikke en separat MQTT forbindelse til din Cerbo GX eller anden Victron GX enhed. I stedet bruger den MQTT integration allerede konfigureret i Home Assistant.

For at dette skal fungere korrekt, skal Home Assistant 's MQTT mægler være i stand til at gøre to ting:

modtage Victron N/ notifikationstræet fra GX-enheden, og pass R/ Hold eller læs anmodninger tilbage til GX-enheden, således at en periodisk afsender kan holde GX republicere sine data.

Kun Delvs integration i sig selv Lytter. Det sender ingen R/ Anmodninger og nej W/ skrive kommandoer, og derfor ikke bruge MQTT til at ændre indstillinger på dit Victron system.

Denne guide viser hvordan denne forbindelse indstilles.

Hvordan MQTT-forbindelsen fungerer

En typisk Clevr-installation ser sådan her ud:

             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

Der er også trafik i den modsatte retning:

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

Den victron/ del i dette eksempel er en lokal bropræfiks. De faktiske emner på GX-enheden starter stadig direkte med N/ og R/.

Viktron 's nuværende MQTT implementering bruger N/ for anmeldelser R/ for anmodninger og W/ for anmodninger, der kan ændre D- Bus- værdier.

For at kunne integrere Clevr behøver vi kun:

MQTT- navnerum	Retning	Formål
`N/`	GX → Home Assistant	Målinger og oplysninger om udstyr
`R/`	Home Assistant → GX	Læser og bevarer anmodninger
`W/`	Ikke dækket	Ændring af viktron indstilling - ikke påkrævet af Clevr

Denne adskillelse er bevidst.

Hvorfor bruge en MQTT Bridge?

Mange Home Assistant installationer allerede bruger MQTT til andet udstyr: ESPHome enheder, Zigbee gateways, el-målere, sensorer eller andre automatiseringssystemer.

I denne situation, Hjem Assistant bør fortsætte med at bruge sin normale MQTT mægler.

I stedet for at ændre Home Assistant til at bruge GX-enheden som sin MQTT mægler, forbinder vi de to mæglere med en Mosquitto bridge.

Resultatet er 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 anden retning:

Home Assistant publishes:

victron/R/abcdef123456/keepalive

GX receives:

R/abcdef123456/keepalive

Mosquitto understøtter præcis denne type af emne remapping ved hjælp af lokale og eksterne præfikser.

Sted- by- Step installation

Aktivér MQTT-adgang på Victron GX-enheden.
Din GX-enhed skal tillade MQTT-forbindelser fra det lokale netværk.

Moderne Venus OS bruger FlashMQ til sin lokale MQTT service. Victron dokumenterer GX MQTT mægler som værende tilgængelig på TCP port 1883 og / eller 8883, afhængigt af enhedens netværkssikkerhed konfiguration.

Tjek MQTT og lokale netværksadgangsindstillinger på din Cerbo GX eller anden GX-enhed.

Bemærk også GX-enhedens IP-adresse. Vi anbefaler kraftigt at give GX enheden en DHCP reservation eller statisk IP, så dets adresse ikke uventet ændre sig.

Du vil også have brug for VRM Portal- id af GX-enheden.

Victron identificerer alle MQTT-anlæg ved hjælp af dette portal- id, f.eks.:
```
N/abcdef123456/system/0/Ac/Grid/L1/Power
```
I dette eksempel:
```
abcdef123456
```
er portalens id.

Victron dokumenterer portal- id 'et som værende tilgængeligt fra GX-enhedens VRM-indstillinger.
Installere Mosquitto mægler i hjemmet Assistant.
Hvis du allerede bruger MQTT i Home Assistant, kan du normalt springe denne del over.

For Home Assistant OS, åben:

Opsætning → Apps → Installer app

og installere:

Mosquitto mægler

Start Mosquitto app efter installation.

Hjem Assistant anbefaler sin officielle Mosquitto mægler som den enkleste lokale MQTT setup. MQTT integration vil normalt opdage mægleren automatisk.

Så tjek:

Opsætning → Enheder & tjenester → MQTT

Integrationen af MQTT skal vise som forbundet.

Hvis du bruger en separat MQTT-server i stedet for Home Assistant 's Mosquitto app, der er også understøttet. Det vigtige krav er, at dette er den samme mægler, der anvendes af Home Assistant 's MQTT integration.
Aktivér brugerdefinerede Mosquitto konfigurationsfiler.
Åbn Mosquitto mægler app konfiguration.

Aktivér brugerdefineret konfiguration:
```
customize:
  active: true
  folder: mosquitto
```
Home Assistant officielle Mosquitto app vil derefter læse yderligere .conf filer fra:
```
/share/mosquitto/
```
Denne brugerdefinerede indstillingsmekanisme leveres af den officielle Mosquitto app.

Opret Victron broen.

Opret:

/share/mosquitto/victron.conf

En anbefalet konfiguration er:

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

Erstat:

192.168.1.50

med IP-adressen på din GX-enhed.

Erstat:

YOUR_PORTAL_ID

med GX-installationens faktiske portal- ID.

For eksempel:

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 to topic regler er det vigtigste.

Denne regel gælder:

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

abonnenter på dette træ på GX:

N/abcdef123456/#

og placerer det i hjemmet Assistant mægler under:

victron/N/abcdef123456/#

Den anden regel:

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

gør det modsatte for læse anmodninger.

En meddelelse offentliggjort lokalt til:

victron/R/abcdef123456/keepalive

sendes til GX som:

R/abcdef123456/keepalive

Bemærk, at der med fuldt overlæg ng W/ broregel.

Genstart Mosquitto mægleren.
Genstart Mosquitto app efter oprettelse eller ændring victron.conf.

Tjek dens log efter opstart.

Du bør ikke se gentagne forbindelsesfejl for victron-gx Broen.

Hvis GX-enheden ikke accepterer forbindelser på porten 1883, kontrollere sin lokale netværk sikkerhed konfiguration. Nuværende Venus OS installationer kan afsløre MQTT på porten 8883 bruge SSL / TLS i stedet, afhængigt af den valgte sikkerhedsprofil.

Må ikke reducere sikkerheden af et anlæg blot for at gøre eksemplet konfiguration arbejde. Hvis din GX kun er konfigureret til sikker MQTT, skal du konfigurere broen til sin TLS-forbindelse i stedet.
Test af N/ retning.
I Home Assistant åben:

Opsætning → Enheder & tjenester → MQTT → Indstil

Find Lyt til et emne.

Indtast:
```
victron/N/YOUR_PORTAL_ID/#
```
og begynde at lytte.

Du kan i første omgang se meget lidt eller ingenting.

Det er normalt.

Moderne Venus OS udgiver ikke længere det komplette MQTT-træ som beholdt beskeder. En klient, der forbinder, skal anmode om en opdatering ved hjælp af en Victron holde i live.
Test af R/ retning med et levende.
Hold emnet lytter kørende.

I MQTT konfigurationssiden, udgive en MQTT pakke til:
```
victron/R/YOUR_PORTAL_ID/keepalive
```
med en tom last.

Broen fjerner victron/ prefix og GX modtager:
```
R/YOUR_PORTAL_ID/keepalive
```
GX bør derefter offentliggøre sine nuværende MQTT-data.

Indenfor Home Assistant bør du begynde at se beskeder såsom:
```
victron/N/YOUR_PORTAL_ID/system/0/...
```
```
victron/N/YOUR_PORTAL_ID/solarcharger/...
```
```
victron/N/YOUR_PORTAL_ID/pvinverter/...
```
og andre enheder installeret på dit system.

I slutningen af en komplet opdatering, seneste Venus OS versioner også offentliggøre:
```
N/YOUR_PORTAL_ID/full_publish_completed
```
Victron anbefaler specifikt R/<portal-id>/keepalive mekanisme til at anmode om det nuværende MQTT-træ.
Opsætning af præcis én periodisk fuld- republicér afsender.
GX 'en udgiver kun sit komplette MQTT-træ, når det bliver bedt om det. Den Clevr integration og Clevr panel aldrig spørge: noget andet på dit websted skal gøre det.

Indstil nøjagtig én afsender pr. GX der offentliggør en af disse anmodninger om hvert 30 sekunder:
```
victron/R/YOUR_PORTAL_ID/keepalive            (empty payload)
```
eller en read request:
```
victron/R/YOUR_PORTAL_ID/system/0/Serial     (empty payload)
```
Begge gør GX offentliggøre sin fulde træ, slutter med N/YOUR_PORTAL_ID/full_publish_completed.

Tjek først, om dit websted allerede har en. Node- RED strømme, andre Victron-integreringer eller en eksisterende Home Assistant automatisering ofte allerede sende en keep alive. Lyt til victron/R/YOUR_PORTAL_ID/# et minut: Hvis anmodninger ankommer regelmæssigt, skal du beholde afsenderen og ikke tilføje en anden. En anden afsender får GX 'en til at genudgive hele sit træ dobbelt så ofte, uden gavn.

Hvis der ikke er nogen, en Home Assistant automatisering er den enkleste afsender. Opret en ny automatisering, skift til Redigér i YAML og paste (med dit eget portal- id og præfiks):
```
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
```
Brug ikke suppress-republish Option med at holde liv (en permanent nyttelast såsom {"keepalive-options": ["suppress-republish"]}). Det forhindrer GX 'en i at sende full_publish_completed, som Clevr setup har brug for, og panelværdier, der ikke ændrer sig, kan gå skævt efter 65 sekunder.

Hvorfor 30 sekunder: GX accepterer et holdalive interval på op til 60 sekunder, men 30 sekunder lader setup scanningen se to komplette publikationer inden for sin 130- anden grænse og holder panelværdier godt inden for deres 65- anden friskhed grænse.

Kontroller resultatet: lyt til victron/N/YOUR_PORTAL_ID/full_publish_completed. En ny besked kommer hvert 30. sekund.
Indstil Clevr Victron integration.
Når broen arbejder, installere eller konfigurere Clevr Victron Panel integration.

Når den anmoder om:

MQTT-bropræfiks

indtast:
```
victron/
```
Når den anmoder om:

GX Portal- id

Indtast dit faktiske portal- id:
```
abcdef123456
```
Derfor vil Clevr se under:
```
victron/N/abcdef123456/
```
Det sender ikke noget til victron/R/abcdef123456/: anmodningerne der kommer fra din periodiske afsender.

Scanningen venter på 130 sekunder for to komplette GX publikationer, så den periodiske afsender fra trin 8 skal allerede køre, når du tilføjer integration.

Forståelse af MQTT-præfikset

Præfikset i Clevr-konfigurationen skal matche hvad der findes på Home Assistant MQTT mægler, ikke nødvendigvis hvad der findes på GX selv.

For eksempel:

Topics synlige i Home Assistant	Clevr MQTT-præfiks
`victron/N/<portal>/...`	`victron/`
`gx/N/<portal>/...`	`gx/`
`energy/victron/N/<portal>/...`	`energy/victron/`
`N/<portal>/...`	Lad præfikset være tomt

For brokonfigurationen vist i denne artikel, anvendes:

victron/

Hvis Home Assistant forbinder direkte til GX MQTT mægler og ser emner, der starter direkte med:

N/<portal-id>/

så bør CIV-præfikset være tomt.

Hvorfor Keeplalive er vigtig

Victron 's nuværende MQTT-implementering er ikke afhængig af tilbageholdte beskeder til det komplette enhedstræe.

I stedet tilmelder ansøgningerne sig N/ træ og derefter anmode om de aktuelle data ved hjælp af:

R/<portal-id>/keepalive

GX reagerer ved at offentliggøre sine tilgængelige data igen. Victron dokumenterer en 60- sekunders keep alive timeout og anbefaler periodisk opfriskning af den, mens en MQTT applikation er aktiv.

Integrationen af Clevr sender ikke keepalives. Det lytter kun til de data, din GX udgiver. Siden 2.1.0-7 har det ikke R/ anmodninger overhovedet, under opsætning eller ved kørsel.

De har derfor brug for nøjagtigt én periodisk afsender pr. GX, omkring hvert 30 sekunder, som beskrevet i trin 8. Med ingen finder opsætningsscanningen ingen komplet publikation, og panelets værdier går skævt. Med to eller flere, GX genudgiver hele sit træ oftere end nødvendigt.

Clevr skriver ikke indstillinger til GX

Denne skelnen er vigtig.

Victron MQTT bruger:

N/

for anmeldelser

R/

til læsning

og:

W/

for skriftlige anmodninger. Victron 's dokumentation viser, at W/ anmodninger kan ændre D- Bus- værdier og derfor ændre operativindstillinger.

Det er ikke tilfældet med Clevr Victron-integrationen. ikke har brug for W/ navnerum.

Vores anbefalede Mosquitto konfiguration indeholder derfor:

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

men det gør det bevidst ikke indeholde:

topic W/# out

Dette giver et ekstra beskyttelseslag på selve MQTT-broen.

Selv hvis en anden klient ved et uheld offentliggør:

victron/W/...

til Home Assistant mægler, broen konfiguration vist her har ingen regel, der tillader, at beskeden til at nå GX-enheden.

Til integration af Clevr er viktron-forbindelsen derfor designet omkring overvågning og læsning anmodninger, ikke kontrol over GX indstillinger.

Fejlfinding

Problem	Hvad skal jeg tjekke?
MQTT integration er ikke tilgængelig	Kontroller, at Home Assistant Mosquitto mægler kører
Broen vil ikke forbinde	Verificer GX IP-adresse, MQTT-adgang og den port, der er tilladt af GX-sikkerhedsprofilen
Nej `victron/N/...` emner vises	Send en `R/<portal>/keepalive`; moderne GX MQTT data er ikke blot opbevares for evigt
`N/` data ankommer, men Clevr rapporterer "Ingen friske GX data"	Kontroller CIV Portal- ID og MQTT - præfikset
Keeplain giver ingen respons	Tjek at `R/` Broregel er til stede og punkter fra Home Assistant til GX
Emner begynder med `N/...` I stedet for `victron/N/...`	Forbindelsen har ingen lokal præfiks; lad Præfikset for Clevr MQTT være tomt
Emner vises under et andet præfiks	Indtast det komplette præfiks i Clevr opsætningen
Port 1883 er afslået	Tjek GX 's sikkerhedsprofil for lokalnetværk; installationen kan kræve sikker MQTT på port 8883
Data vises kort og derefter stopper	Ingen periodisk afsender kører, eller `R/` broregel ikke videregive sine anmodninger til GX
Opstillingsrapporter for Clevr “Ingen nye GX- data” eller finder kun en del af systemet	Kontroller, at en afsender udgiver en keeplife omkring hvert 30 sekunder, og at `full_publish_completed` ankommer; brug ikke `suppress-republish`
Fuld publicerer ankommer oftere end hvert 30 sekunder	To eller flere afsendere er aktive (for eksempel Node- RED og en Home Assistant automatisering); holde kun én

Det endelige resultat

Når denne konfiguration er færdig, Home Assistant bør have en tovejs read- only MQTT path til 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

Der er med vilje ingen tilsvarende sti for:

W/

Med dette MQTT lag arbejder, kan du fortsætte med at installere Clevr Victron Panel integration til Home Assistant. Integrationen vil bruge Home Assistant eksisterende MQTT-forbindelse til at opdage dit Victron-system, MPPT solopladere, gitter og batteri enheder, og understøttet AC PV invertere såsom Fronius.

Ingen yderligere MQTT-akkreditiver behøver at blive optaget i Clevr Home Assistant integration.

Næste trin: installere selve integrationen — Se Tilslut Victron GX og Fronius til Home Assistant med CleV Victron Integration. Så indstille dit Clevr GX- panel.