Conectați Home Assistant MQTT la un Victron GX: Configurați podul N/R MQTT

Actualizat la 26 septembrie 2026 (Clevr Victron 2.1.0-dev7): Versiunile anterioare ale acestui ghid spuneau că integrarea Clevr trimite automat vie vie Victron. Nu. Integrarea doar ascultă. Acum ai nevoie exact un expeditor periodic per GX care cere o respingere completă aproximativ la fiecare 30 de secunde — Vezi? Etapa 8. Dacă configurați Clevr 2.1.0-dev5 cu Home-Asistent-managed keevalive, adăugați acest expeditor înainte upgrade.

ă Integrare Clevr Victron pentru Asistent Home citeste informatii despre Victron si Fronius prin MQTT.

Nu creează o conexiune MQTT separată la dispozitivul dumneavoastră Cerbo GX sau la alt dispozitiv Victron GX. În schimb, foloseşte Integrare MQTT deja configurată în Home Assistant.

Pentru ca acest lucru să funcționeze corect, Home Assistant MQTT broker trebuie să poată face două lucruri:

vi se administrează Victron N/ arborele de notificare de pe dispozitivul GX, și pass R/ păstrează în viață sau citiți cererile înapoi la dispozitivul GX, astfel încât un expeditor periodic poate păstra GX republishing datele sale.

Numai integrarea Clevrului Ascultă.. Acesta trimite nu R/ cereri și nu W/ scrie comenzi, și, prin urmare, nu utilizează MQTT pentru a schimba setările pe sistemul Victron.

Acest ghid arată modul de configurare a acestei conexiuni.

Cum funcționează conexiunea MQTT

O instalaţie tipică Clevr arată aşa:

             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

Există, de asemenea, trafic în direcţia opusă:

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

ă victron/ parte în acest exemplu este o Prefix pod local. Subiectele reale de pe dispozitivul GX încă încep direct cu N/ şi R/.

Implementarea actuală a MQTT a lui Victron N/ pentru notificări; R/ pentru a citi cererile și W/ pentru cererile care pot modifica valorile D-bus.

Pentru integrarea Clevr avem nevoie doar de:

Namespace MQTT	Direcţie	Scop
`N/`	GX → Home Assistant	Măsurători și informații privind dispozitivul
`R/`	Home Assistant → GX	Citește și păstrează cereri în viață
`W/`	Fără pod	Setarea modificărilor Victron

Această separare este deliberată.

De ce să folosim un pod MQTT?

Multe instalații Home Assistant folosesc deja MQTT pentru alte echipamente: dispozitive ESPHome, porți de acces Zigbee, contoare de putere, senzori sau alte sisteme de automatizare.

În această situație, Home Assistant ar trebui să continue utilizarea brokerului său normal MQTT.

În loc să schimbăm Home Assistant pentru a folosi dispozitivul GX ca broker MQTT, îi conectăm pe cei doi brokeri cu un Podul ţânţarilor.

Rezultatul este simplu:

GX topic:

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

becomes in Home Assistant:

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

În cealaltă direcţie:

Home Assistant publishes:

victron/R/abcdef123456/keepalive

GX receives:

R/abcdef123456/keepalive

Mosquitto suporta exact acest tip de topic remapping folosind prefixe locale si de la distanta.

Instalare pas cu pas

Activează accesul MQTT pe dispozitivul Victron GX.
Dispozitivul GX trebuie să permită conexiunile MQTT de la rețeaua locală.

Modern Venus OS folosește FlashMQ pentru serviciul său local MQTT. Victron documentează brokerul GX MQTT ca fiind disponibil pe portul TCP 1883 și/sau 8883, în funcție de configurația de securitate a dispozitivului.

Verificați setările de acces MQTT și rețeaua locală de pe dispozitivul Cerbo GX sau alt dispozitiv GX.

Notează şi adresa IP a dispozitivului GX. Vă recomandăm cu tărie să oferim dispozitivului GX o rezervare DHCP sau IP statică astfel încât adresa sa să nu se schimbe pe neaşteptate.

Veți avea nevoie, de asemenea ID-ul portalului VRM a dispozitivului GX.

Victron identifică fiecare instalație MQTT utilizând acest ID portal, de exemplu:
```
N/abcdef123456/system/0/Ac/Grid/L1/Power
```
În acest exemplu:
```
abcdef123456
```
este ID-ul portalului.

Victron documentează ID-ul portalului ca fiind disponibil din setările VRM ale dispozitivului GX.
Instalați brokerul țânțar în Home Assistant.
Dacă utilizați deja MQTT în Home Assistant, puteți sări peste această parte.

Pentru Home Assistant OS, deschis:

Configurări → Aplicații → Instalare aplicație

și instalați:

Broker țânțar

Porniți aplicația Mosquitto după instalare.

Home Assistant recomandă brokerul său oficial Mosquitto ca cel mai simplu setup local MQTT. Integrarea MQTT va descoperi automat brokerul.

Apoi verificaţi:

Configurări → Dispozitive & servicii → MQTT

Integrarea MQTT ar trebui să arate ca fiind conectată.

Dacă utilizați un server MQTT separat în loc de aplicația Home Assistant's Mosquitto, care este, de asemenea, suportat. Cerința importantă este că acesta este același broker utilizat de integrarea MQTT Home Assistant.
Activează fișierele de configurare Mosquitto personalizate.
Deschide Broker țânțar configurare aplicație.

Activează configurația personalizată:
```
customize:
  active: true
  folder: mosquitto
```
Acasă Aplicația oficială a asistentului țânțar va citi apoi suplimentare .conf fișiere din:
```
/share/mosquitto/
```
Acest mecanism de configurare personalizat este furnizat de aplicația oficială Mosquitto.

Creează podul Victron.

Creează:

/share/mosquitto/victron.conf

O configuraţie recomandată este:

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

Înlocuiește:

192.168.1.50

cu adresa IP a dispozitivului GX.

Înlocuiește:

YOUR_PORTAL_ID

cu ID-ul real al instalației GX.

De exemplu:

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

Cei doi topic Regulile sunt partea importantă.

Această regulă:

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

subscrie la acest copac pe GX:

N/abcdef123456/#

şi pune-l în Home Assistant broker sub:

victron/N/abcdef123456/#

A doua regulă:

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

face opusul cererilor de citire.

Un mesaj publicat la nivel local către:

victron/R/abcdef123456/keepalive

este trimis la GX ca:

R/abcdef123456/keepalive

Observaţi că există în mod deliberat nu W/ Regula podului.

Reporneşte brokerul de ţânţari.
Reporniți aplicația Mosquitto după crearea sau modificarea victron.conf.

Verificați jurnalul său după pornire.

Nu trebuie să vedeți erori de conectare repetate pentru victron-gx Puntea.

Dacă dispozitivul GX nu acceptă conexiuni în port 1883, verificaţi configuraţia de securitate a reţelei locale. Instalațiile actuale Venus OS pot expune MQTT în port 8883 utilizarea SSL/TLS în schimb, în funcție de profilul de securitate selectat.

Nu reduceți securitatea unei instalații doar pentru a face ca configurația exemplului să funcționeze. Dacă GX este configurat numai pentru MQTT securizat, configurați podul pentru conexiunea TLS în schimb.
Testaţi N/ direcţie.
In Home Assistant deschis:

Configurări → Dispozitive & Servicii → MQTT → Configurează

Caută Ascultă un subiect.

Introduceți:
```
victron/N/YOUR_PORTAL_ID/#
```
şi începe să asculţi.

S-ar putea vedea inițial foarte puțin sau nimic.

E normal.

Modern Venus OS nu mai publică întregul arbore MQTT ca mesaje păstrate. Un client care se conectează trebuie să solicite o reîmprospătare folosind o pastrare Victron.
Testaţi R/ directie cu o pastrare in viata.
Ţine subiectul în funcţiune.

În pagina de configurare MQTT, se publică un pachet MQTT pentru:
```
victron/R/YOUR_PORTAL_ID/keepalive
```
cu o sarcină utilă goală.

Podul elimină victron/ prefixul și GX primește:
```
R/YOUR_PORTAL_ID/keepalive
```
GX ar trebui apoi să publice datele MQTT actuale.

În cadrul Home Assistant ar trebui să începeți să vedeți mesaje precum:
```
victron/N/YOUR_PORTAL_ID/system/0/...
```
```
victron/N/YOUR_PORTAL_ID/solarcharger/...
```
```
victron/N/YOUR_PORTAL_ID/pvinverter/...
```
și alte dispozitive instalate pe sistemul dumneavoastră.

La finalul unei reîmprospătări complete, versiunile recente Venus OS publică de asemenea:
```
N/YOUR_PORTAL_ID/full_publish_completed
```
Victron recomandă în special R/<portal-id>/keepalive mecanism de solicitare a copacului curent MQTT.
Setați exact un expeditor periodic complet-republish.
GX repulsează copacul complet MQTT doar atunci când este solicitat. Integrarea Clevr și panoul Clevr nu cer niciodată: altceva pe site-ul dvs. trebuie să o facă.

Configurează exact un expeditor per GX care publică una dintre aceste solicitări aproximativ la fiecare 30 de secunde:
```
victron/R/YOUR_PORTAL_ID/keepalive            (empty payload)
```
sau o cerere de citire:
```
victron/R/YOUR_PORTAL_ID/system/0/Serial     (empty payload)
```
Ambele fac GX publica copacul complet, se încheie cu N/YOUR_PORTAL_ID/full_publish_completed.

Verificați mai întâi dacă site-ul are deja unul. Fluxurile Node-RED, alte integrări Victron sau o automatizare existentă Home Assistant trimite de multe ori deja un keepalive. Ascultă. victron/R/YOUR_PORTAL_ID/# pentru un minut: dacă cererile sosesc regulat, păstrați expeditorul și nu adăugați altul. Un al doilea expeditor face ca GX să-şi respingă întregul copac de două ori mai des, fără nici un beneficiu.

Dacă nu există, o automatizare Home Assistant este cel mai simplu expeditor. Creați o nouă automatizare, comutați la Editează în YAML și pastă (cu propriul ID portal și 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
```
Nu utilizaţi suppress-republish opțiunea de menținere a vieții (o sarcină utilă continuă, cum ar fi {"keepalive-options": ["suppress-republish"]}). Opreşte trimiterea GX full_publish_completed, de care Clevr are nevoie, și valorile panou care nu se schimbă pot merge vechi după 65 de secunde.

De ce 30 de secunde: GX acceptă un interval keenalive de până la 60 de secunde, dar 30 de secunde permite scanarea setup vedea două publicații complete în limita de 130 de secunde și păstrează valorile panou bine în interiorul lor 65-secunde prospețime limita.

Verificați rezultatul: ascultați victron/N/YOUR_PORTAL_ID/full_publish_completed. Un mesaj nou ar trebui să sosească la fiecare 30 de secunde.
Configurați integrarea Clevr Victron.
Odată ce podul funcţionează, instalează sau configurează Panou Victron Clevr integrarea.

Când cere:

Prefix pod MQTT

introduce:
```
victron/
```
Când cere:

ID-ul portalului GX

introduceți ID-ul real al portalului:
```
abcdef123456
```
Prin urmare, Clevr va privi sub:
```
victron/N/abcdef123456/
```
Nu trimite nimic victron/R/abcdef123456/: cererile de acolo provin de la expeditor periodic.

Scanarea de configurare așteaptă până la 130 secunde pentru două publicaţii complete GX, astfel încât expeditorul periodic din etapa 8 trebuie să fie deja difuzate atunci când adăugaţi integrarea.

Înțelegerea prefixului MQTT

Prefixul introdus în configurația Clevr trebuie să se potrivească cu ceea ce există pe Home Assistant broker MQTTNu neapărat ceea ce există pe GX.

De exemplu:

Subiecte vizibile în Home Assistant	Prefix Clevr MQTT
`victron/N/<portal>/...`	`victron/`
`gx/N/<portal>/...`	`gx/`
`energy/victron/N/<portal>/...`	`energy/victron/`
`N/<portal>/...`	lasă prefixul gol

Pentru configurația podului din acest articol, utilizați:

victron/

Dacă Home Assistant se conectează direct la brokerul GX MQTT și vede subiecte care încep direct cu:

N/<portal-id>/

atunci prefixul Clevr ar trebui lăsat gol.

De ce este important să rămânem în viaţă

Punerea în aplicare actuală a MQTT Victron nu se bazează pe mesajele reținute pentru arborele complet al dispozitivului.

În schimb, cererile subscriu la N/ arbore și apoi să solicite datele curente utilizând:

R/<portal-id>/keepalive

GX răspunde prin publicarea din nou a datelor disponibile. Victron documentează o pauză de 60 de secunde și recomandă periodic revigorarea acesteia în timp ce o aplicație MQTT este activă.

Integrarea Clevr nu trimite vieti. Ascultă doar datele publicate de GX. De la 2.1.0-dev7 trimite nu R/ cereri la toate, în timpul configuraţiei sau la termen.

Prin urmare, aveţi nevoie exact un expeditor periodic per GX, aproximativ la fiecare 30 de secunde, după cum este descris în Etapa 8. Cu nici unul, scanarea de configurare nu găsește nici o publicare completă și valorile panoului merge vechi. Cu două sau mai multe, GX-ul îşi repulsează întregul copac mai des decât este necesar.

Clevr nu scrie setări pe GX

Această distincţie este importantă.

Victron MQTT utilizează:

N/

pentru notificări;

R/

pentru citiri,

și:

W/

pentru a scrie cereri. Documentaţia lui Victron arată că W/ cererile pot modifica valorile D- Bus și, prin urmare, pot modifica setările de operare.

Integrarea Clevr Victron nu nu nevoie de W/ namespace.

Configuraţia recomandată de ţânţari conţine:

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

dar în mod deliberat nu nu conţine:

topic W/# out

Aceasta oferă un strat suplimentar de protecție la podul MQTT în sine.

Chiar dacă un alt client publică accidental:

victron/W/...

la Home Assistant broker, configuraţia podului arătată aici nu are nici o regulă care permite ca acest mesaj să ajungă la dispozitivul GX.

Pentru integrarea Clevr, conexiunea Victron este, prin urmare, proiectat în jurul monitorizarea și citirea cererilor, nu controlul setărilor GX.

Depanare

Problemă	Ce trebuie verificat
Integrarea MQTT nu este disponibilă	Verificați dacă Home Assistant Mosquitto broker este difuzate
Puntea nu se va conecta	Verificați adresa GX IP, accesul MQTT și portul permis de profilul de securitate GX
Nu. `victron/N/...` apar subiecte	Trimite un `R/<portal>/keepalive`; datele moderne GX MQTT nu sunt pur și simplu păstrate pentru totdeauna
`N/` Sosește date, dar rapoartele Clevr	Verificați ID-ul portalului Clevr și prefixul MQTT
Păstrarea vie nu produce nici un răspuns	Verificaţi dacă `R/` Regula podului este prezentă și puncte de la Home Assistant la GX
Subiectele încep cu `N/...` Mai degrabă decât `victron/N/...`	Conexiunea nu are prefix local; lăsați prefixul Clevr MQTT gol
Subiectele apar sub un prefix diferit	Introduceți acel prefix complet în configurarea Clevr
Portul 1883 este refuzat.	Verificați profilul GX de securitate a rețelei locale; instalarea poate necesita MQTT securizat pe portul 8883
Datele apar pe scurt şi apoi se opresc	Nici un expeditor periodic este difuzate, sau `R/` Regula podului nu transmite cererile sale către GX
Rapoarte de configurare Clevr “Fără date GX proaspete” sau găsește doar o parte a sistemului	Verificați că un expeditor publică un keepalive aproximativ la fiecare 30 de secunde și că `full_publish_completed` soseşte; nu utilizaţi `suppress-republish`
Publicaţiile complete sosesc mai des decât la fiecare 30 de secunde	Doi sau mai mulți expeditori sunt activi (de exemplu Node-RED și o automatizare Home Assistant); păstrați doar unul

Rezultatul final

Odată ce această configurație este completă, Home Assistant ar trebui să aibă un bidirecțional calea MQTT numai pentru citire la 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

Nu există în mod intenționat nicio cale corespunzătoare pentru:

W/

Cu acest strat MQTT de lucru, puteți continua să instalați Clevr Victron Panel Integrare pentru Home Assistant. Integrarea va utiliza conexiunea MQTT existentă de la Home Assistant pentru a descoperi sistemul Victron, încărcătoarele solare MPPT, dispozitivele de rețea și baterie și invertoarele fotovoltaice AC sprijinite, cum ar fi Fronius.

Nu este necesar să se introducă alte acreditări MQTT în integrarea Clevr Home Assistant.

Pasul următor: instalarea integrării în sine — Vezi? Conectați Victron GX și Fronius la Home Assistant cu integrarea Clevr Victron. Atunci Configurează panoul GX Clevr.