Conectează Home Assistant prin MQTT la Victron GX: configurează puntea MQTT N/R

Actualizat la 26 septembrie 2026 (Clevr Victron 2.1.0-dev7): versiunile anterioare ale acestui ghid afirmau că integrarea Clevr trimite automat cereri keepalive către Victron. Nu le trimite. Integrarea doar ascultă. Acum ai nevoie de un singur emițător periodic pentru fiecare GX care să solicite republicarea completă a datelor aproximativ la fiecare 30 de secunde; vezi pasul 8. Dacă ai configurat Clevr 2.1.0-dev5 cu keepalive gestionat de Home Assistant, adaugă acest emițător înainte de actualizare.

Integrarea Clevr Victron pentru Home Assistant citește informații Victron și Fronius prin MQTT.

Nu creează o conexiune MQTT separată la Cerbo GX sau la alt dispozitiv Victron GX. Folosește în schimb integrarea MQTT deja configurată în Home Assistant.

Pentru ca totul să funcționeze corect, brokerul MQTT al Home Assistant trebuie să poată:

primi arborele de notificări Victron N/ de la dispozitivul GX, și transmite R/ cereri keepalive sau de citire înapoi la dispozitivul GX, astfel încât un emițător periodic să determine GX să-și republice datele.

Integrarea Clevr doar ascultă. Nu trimite cereri R/ și nici comenzi W/ de scriere; prin urmare, nu folosește MQTT pentru a modifica setările sistemului 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/ din acest exemplu reprezintă un prefix local al punții. Topicurile de pe dispozitivul GX încep în continuare direct cu N/ și R/.

Implementarea MQTT actuală de la Victron folosește N/ pentru notificări, R/ pentru cereri de citire și W/ pentru cereri care pot modifica valorile D-Bus.

Pentru integrarea Clevr avem nevoie doar de:

Spațiu de nume MQTT	Direcție	Scop
`N/`	GX → Home Assistant	Măsurători și informații privind dispozitivul
`R/`	Home Assistant → GX	Cereri de citire și keepalive
`W/`	Nu se transmite prin punte	Modificări ale setărilor Victron, nenecesare pentru Clevr

Această separare este deliberată.

De ce să folosești o punte 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ă modificăm Home Assistant pentru a folosi dispozitivul GX drept broker MQTT, conectăm cei doi brokeri printr-o punte Mosquitto.

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 permite exact acest tip de remapare a topicurilor, folosind prefixe locale și la distanță.

Instalare pas cu pas

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

Versiunile moderne Venus OS folosesc FlashMQ pentru serviciul MQTT local. Potrivit documentației Victron, brokerul MQTT de pe GX este disponibil pe porturile 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. Îți recomandăm să configurezi o rezervare DHCP sau o adresă IP statică, astfel încât adresa să nu se schimbe pe neașteptate.

Vei avea nevoie și de 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.
Instalează brokerul Mosquitto în Home Assistant.
Dacă utilizați deja MQTT în Home Assistant, puteți sări peste această parte.

Pentru Home Assistant OS, deschide:

Settings → Apps → Install app

și instalează:

Mosquitto broker

Porniți aplicația Mosquitto după instalare.

Home Assistant recomandă brokerul oficial Mosquitto drept cea mai simplă soluție MQTT locală. În mod normal, integrarea MQTT detectează automat brokerul.

Apoi verificați:

Settings → Devices & services → MQTT

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

Poți folosi și un server MQTT separat în locul aplicației Mosquitto din Home Assistant. Important este să fie același broker pe care îl folosește integrarea MQTT din Home Assistant.
Activează fișierele de configurare Mosquitto personalizate.
Deschide configurația aplicației Mosquitto broker .

Activează configurația personalizată:
```
customize:
  active: true
  folder: mosquitto
```
Aplicația oficială Mosquitto din Home Assistant va citi apoi fișierele suplimentare .conf din:
```
/share/mosquitto/
```
Acest mecanism de configurare personalizat este furnizat de aplicația oficială Mosquitto.

Creează puntea 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/ ""

Cele două reguli topic sunt esențiale.

Această regulă:

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

se abonează la acest arbore de topicuri de pe GX:

N/abcdef123456/#

și îl plasează în brokerul Home Assistant sub:

victron/N/abcdef123456/#

A doua regulă:

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

face operația inversă pentru cererile de citire.

Un mesaj publicat la nivel local către:

victron/R/abcdef123456/keepalive

este trimis la GX ca:

R/abcdef123456/keepalive

Observă că, în mod intenționat, nu există nicio regulă de punte pentru W/ .

Repornește brokerul Mosquitto.
Reporniți aplicația Mosquitto după crearea sau modificarea victron.conf.

Verificați jurnalul său după pornire.

Nu ar trebui să apară erori repetate de conectare pentru puntea victron-gx .

Dacă dispozitivul GX nu acceptă conexiuni pe portul 1883, verifică setările de securitate ale rețelei locale. În funcție de configurație, versiunile actuale Venus OS pot oferi MQTT pe portul 8883 prin SSL/TLS, în funcție de profilul de securitate selectat.

Nu reduce securitatea instalației doar pentru a face exemplul să funcționeze. Dacă GX acceptă numai MQTT securizat, configurează puntea pentru conexiunea TLS.
Testează sensul N/ .
În Home Assistant, deschide:

Settings → Devices & services → MQTT → Configure

Caută Listen to a topic.

Introdu:
```
victron/N/YOUR_PORTAL_ID/#
```
și începe să asculți.

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

E normal.

Versiunile moderne Venus OS nu mai publică întregul arbore MQTT sub formă de mesaje reținute (retained). Un client nou conectat trebuie să solicite actualizarea printr-o cerere keepalive Victron.
Testează sensul R/ printr-o cerere keepalive.
Lasă ascultarea topicului activă.

În pagina de configurare MQTT, publică un pachet către:
```
victron/R/YOUR_PORTAL_ID/keepalive
```
cu un payload gol.

Puntea elimină prefixul victron/ iar 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 în sistemul tău.

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 pentru solicitarea arborelui MQTT actual.
Configurează un singur emițător periodic pentru republicarea completă.
GX își republică întregul arbore MQTT doar la cerere. Integrarea Clevr și panoul Clevr nu trimit astfel de cereri: este necesară o altă componentă din instalație.

Configurează un singur emițător pentru fiecare 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 determină GX să publice întregul arbore, încheind cu N/YOUR_PORTAL_ID/full_publish_completed.

Verifică mai întâi dacă instalația are deja un astfel de emițător. Fluxurile Node-RED, alte integrări Victron sau o automatizare Home Assistant existentă trimit adesea deja cereri keepalive. Ascultă victron/R/YOUR_PORTAL_ID/# timp de un minut: dacă cererile sosesc regulat, păstrează emițătorul existent și nu adăuga altul. Un al doilea emițător ar face GX să republice întregul arbore de două ori mai des, fără niciun beneficiu.

Dacă nu există unul, o automatizare Home Assistant este cea mai simplă variantă. Creează o automatizare nouă, treci la Edit in YAML și lipește următorul cod, folosind propriul Portal ID și propriul 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 keepalive (un payload keepalive precum {"keepalive-options": ["suppress-republish"]}). Aceasta împiedică GX să trimită full_publish_completed, necesar pentru configurarea Clevr, iar valorile panoului care nu se schimbă pot fi considerate neactualizate după 65 de secunde.

De ce 30 de secunde? GX acceptă un interval keepalive de până la 60 de secunde, dar un interval de 30 de secunde permite scanării de configurare să primească două publicări complete în limita de 130 de secunde și menține datele panoului în limita de actualitate de 65 de secunde.

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.
După ce puntea funcționează, instalează sau configurează integrarea Clevr Victron Panel .

Când cere:

prefixul punții MQTT

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

ID-ul portalului GX

introduceți ID-ul real al portalului:
```
abcdef123456
```
Clevr va căuta așadar sub:
```
victron/N/abcdef123456/
```
Nu trimite nimic către victron/R/abcdef123456/: cererile de acolo provin de la emițătorul periodic.

Scanarea de configurare așteaptă până la 130 secunde pentru a primi două publicări complete GX. Prin urmare, emițătorul periodic de la pasul 8 trebuie să ruleze deja atunci când adaugi integrarea.

Înțelegerea prefixului MQTT

Prefixul introdus în configurația Clevr trebuie să se potrivească cu ceea ce există pe brokerul MQTT al Home Assistant, nu neapărat cu cel de pe GX.

De exemplu:

Topicuri 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 punții din acest articol, folosește:

victron/

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

N/<portal-id>/

atunci prefixul Clevr ar trebui lăsat gol.

De ce sunt importante cererile keepalive

Implementarea MQTT actuală de la Victron nu se bazează pe mesaje reținute pentru întregul arbore al dispozitivului.

În schimb, aplicațiile se abonează la arborele N/ și apoi solicită datele actuale folosind:

R/<portal-id>/keepalive

GX răspunde prin republicarea datelor disponibile. Documentația Victron indică un timeout keepalive de 60 de secunde și recomandă reînnoirea periodică a cererii cât timp aplicația MQTT este activă.

Integrarea Clevr nu trimite cereri keepalive. Doar ascultă datele publicate de GX. Începând cu versiunea 2.1.0-dev7, nu trimite deloc cereri R/ , nici la configurare, nici în timpul funcționării.

Ai nevoie, așadar, de un singur emițător periodic pentru fiecare GX, aproximativ la fiecare 30 de secunde, după cum este descris în pasul 8. Fără un emițător, scanarea de configurare nu primește o publicare completă, iar valorile panoului devin neactualizate. Cu doi sau mai mulți emițători, GX republică întregul arbore 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 cereri de scriere. Documentația Victron arată că aceste cereri W/ pot modifica valorile D-Bus și, implicit, setările de funcționare.

Integrarea Clevr Victron nu are nevoie de spațiul de nume W/ .

Prin urmare, configurația Mosquitto recomandată conține:

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

dar, în mod intenționat, nu conține:

topic W/# out

Aceasta oferă un nivel suplimentar de protecție chiar la nivelul punții MQTT.

Chiar dacă un alt client publică accidental:

victron/W/...

către brokerul Home Assistant, configurația punții din acest exemplu nu include nicio regulă care să permită mesajului să ajungă la dispozitivul GX.

Pentru integrarea Clevr, conexiunea Victron este concepută pentru monitorizare și cereri de citire, nu pentru modificarea setărilor GX.

Depanare

Problemă	Ce trebuie verificat
Integrarea MQTT nu este disponibilă	Verifică dacă brokerul Mosquitto din Home Assistant rulează
Puntea nu se conectează	Verifică adresa IP a GX, accesul MQTT și portul permis de profilul de securitate GX
Nu apar topicuri `victron/N/...`	Trimite un `R/<portal>/keepalive`; în versiunile moderne GX, datele MQTT nu rămân pur și simplu memorate permanent
`N/` sunt primite, dar Clevr afișează „No fresh GX data”	Verificați ID-ul portalului Clevr și prefixul MQTT
Cererea keepalive nu primește răspuns	Verificați dacă `R/` pentru punte există și transmite din Home Assistant către GX
Topicurile încep cu `N/...` în loc de `victron/N/...`	Conexiunea nu are prefix local; lăsați prefixul Clevr MQTT gol
Topicurile apar sub alt prefix	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	Nu rulează niciun emițător periodic sau regula `R/` a punții nu transmite cererile către GX
Configurarea Clevr afișează „No fresh GX data” sau detectează doar o parte din sistem	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`
Publicările complete sosesc mai des de o dată la 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

După finalizarea configurării, Home Assistant ar trebui să aibă o cale MQTT bidirecțională, numai pentru citire, către 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/

După ce conexiunea MQTT funcționează, poți instala Clevr Victron Panel pentru Home Assistant. Integrarea va folosi conexiunea MQTT existentă din Home Assistant pentru a detecta sistemul Victron, încărcătoarele solare MPPT, dispozitivele pentru rețea și baterie, precum și invertoarele fotovoltaice AC compatibile, de exemplu Fronius.

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

Pasul următor: instalează integrarea propriu-zisă; vezi Conectează Victron GX și Fronius la Home Assistant prin integrarea Clevr Victron. Apoi Configurează panoul GX Clevr.