Collega MQTT Home Assistant a Victron GX: configura il bridge N/R MQTT

Aggiornato il 26 settembre 2026 (Clevr Victron 2.1.0-dev7): le versioni precedenti dicevano che Clevr invia keepalive automaticamente. Non è così. L’integrazione ascolta soltanto. Ora serve esattamente un mittente periodico per GX che richieda una ripubblicazione completa ogni 30 secondi — vedi passo 8. Se usi 2.1.0-dev5 con keepalive gestito da Home Assistant, aggiungi il mittente prima di aggiornare.

L’integrazione Clevr Victron per Home Assistant legge dati Victron e Fronius via MQTT.

Non crea una connessione MQTT separata al Cerbo GX o altri GX. Usa l’integrazione MQTT già configurata in Home Assistant.

Per funzionare, il broker Home Assistant deve:

ricevere l’albero Victron N/ delle notifiche dal GXe inoltrare richieste R/ keepalive o di lettura al GX, così un mittente periodico mantiene la pubblicazione dei dati.

L’integrazione Clevr ascolta soltanto. Non invia richieste R/ né comandi W/ di scrittura, quindi non modifica impostazioni Victron via MQTT.

La guida mostra come configurare la connessione.

Come funziona la connessione MQTT

Un’installazione Clevr tipica è così:

             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

C’è anche traffico nella direzione opposta:

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

L’victron/ in questo esempio è un prefisso locale del bridge. I topic reali sul GX iniziano ancora direttamente con N/ e R/.

L’implementazione MQTT attuale di Victron usa N/ per notifiche, R/ per letture e W/ per richieste che modificano valori D-Bus.

Per Clevr servono soltanto:

Spazio dei nomi MQTT	Direzione	Scopo
`N/`	GX → Home Assistant	Misure e informazioni sui dispositivi
`R/`	Home Assistant → GX	Richieste di lettura e keepalive
`W/`	Non inoltrato	Modifiche impostazioni Victron — non richieste da Clevr

La separazione è intenzionale.

Perché usare un bridge MQTT?

Molte installazioni usano già MQTT per ESPHome, gateway Zigbee, contatori, sensori e altre automazioni.

Home Assistant deve continuare a usare il broker abituale.

Invece di passare al broker GX, colleghiamo i due broker tramite un bridge Mosquitto.

Il risultato è semplice:

GX topic:

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

becomes in Home Assistant:

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

Nella direzione opposta:

Home Assistant publishes:

victron/R/abcdef123456/keepalive

GX receives:

R/abcdef123456/keepalive

Mosquitto supporta questa rimappatura dei topic con prefissi locali e remoti.

Installazione passo passo

Abilita l’accesso MQTT sul Victron GX.
GX deve permettere connessioni MQTT dalla rete locale.

Venus OS moderno usa FlashMQ. Victron documenta il broker GX sulla porta TCP 1883 e/o 8883, secondo la sicurezza di rete del dispositivo.

Controlla MQTT e accesso locale su Cerbo GX o altro GX.

Annota l’IP GX. Consigliamo una prenotazione DHCP o IP statico per evitare cambiamenti imprevisti.

Ti serve anche il VRM Portal ID del GX.

Victron identifica ogni impianto MQTT con questo Portal ID, ad esempio:
```
N/abcdef123456/system/0/Ac/Grid/L1/Power
```
In questo esempio:
```
abcdef123456
```
è il Portal ID.

Victron indica che il Portal ID è nelle impostazioni VRM del GX.
Installa Mosquitto in Home Assistant.
Se usi già MQTT, di solito puoi saltare questa parte.

In Home Assistant OS apri:

Impostazioni → App → Installa app

e installa:

Broker Mosquitto

Avvia Mosquitto dopo l’installazione.

Home Assistant consiglia il broker ufficiale Mosquitto come soluzione locale più semplice. MQTT normalmente lo rileva automaticamente.

Poi controlla:

Impostazioni → Dispositivi e servizi → MQTT

L’integrazione MQTT deve risultare connessa.

È supportato anche un server MQTT separato. Deve essere lo stesso broker usato dall’integrazione MQTT di Home Assistant.
Abilita file di configurazione Mosquitto personalizzati.
Apri la configurazione di Broker Mosquitto nell’app.

Abilita la configurazione personalizzata:
```
customize:
  active: true
  folder: mosquitto
```
L’app ufficiale leggerà altri file .conf da:
```
/share/mosquitto/
```
Il meccanismo è fornito dall’app ufficiale Mosquitto.

Crea il bridge Victron.

Crea:

/share/mosquitto/victron.conf

Configurazione consigliata:

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

Sostituisci:

192.168.1.50

con l’IP del GX.

Sostituisci:

YOUR_PORTAL_ID

con il Portal ID effettivo dell’impianto.

Ad esempio:

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

Le due topic regole sono fondamentali.

Questa regola:

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

si iscrive a questo albero sul GX:

N/abcdef123456/#

e lo colloca nel broker Home Assistant sotto:

victron/N/abcdef123456/#

La seconda regola:

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

fa l’opposto per le richieste di lettura.

Un messaggio pubblicato localmente su:

victron/R/abcdef123456/keepalive

viene inviato al GX come:

R/abcdef123456/keepalive

Nota che intenzionalmente non c’è W/ regola bridge.

Riavvia il broker Mosquitto.
Riavvia Mosquitto dopo aver creato o modificato victron.conf.

Controlla il registro dopo l’avvio.

Non dovrebbero ripetersi errori di connessione per il bridge victron-gx nel registro.

Se GX non accetta connessioni sulla porta 1883controlla la sicurezza di rete. Venus OS attuale può esporre MQTT sulla porta 8883 con SSL/TLS secondo il profilo di sicurezza.

Non ridurre la sicurezza per far funzionare l’esempio. Se GX accetta solo MQTT sicuro, configura il bridge con TLS.
Prova la direzione N/ di comunicazione.
In Home Assistant apri:

Impostazioni → Dispositivi e servizi → MQTT → Configura

Trova Ascolta un topic.

Inserisci:
```
victron/N/YOUR_PORTAL_ID/#
```
e inizia l’ascolto.

All’inizio potresti vedere poco o nulla.

È normale.

Venus OS moderno non pubblica più l’albero completo come messaggi retained. Il client deve richiedere un aggiornamento tramite keepalive Victron.
Prova la direzione R/ con un keepalive.
Mantieni attivo l’ascolto.

Nella configurazione MQTT pubblica un pacchetto su:
```
victron/R/YOUR_PORTAL_ID/keepalive
```
con payload vuoto.

Il bridge rimuove il prefisso victron/ e GX riceve:
```
R/YOUR_PORTAL_ID/keepalive
```
GX dovrebbe pubblicare i dati attuali.

In Home Assistant dovresti vedere messaggi come:
```
victron/N/YOUR_PORTAL_ID/system/0/...
```
```
victron/N/YOUR_PORTAL_ID/solarcharger/...
```
```
victron/N/YOUR_PORTAL_ID/pvinverter/...
```
e altri dispositivi installati.

Alla fine di un aggiornamento completo, Venus OS recente pubblica anche:
```
N/YOUR_PORTAL_ID/full_publish_completed
```
Victron consiglia il meccanismo R/<portal-id>/keepalive per richiedere l’albero MQTT attuale.
Configura un solo mittente periodico di ripubblicazioni complete.
GX ripubblica l’albero completo solo su richiesta. Integrazione e pannello Clevr non lo richiedono: deve farlo un altro componente.

Configura esattamente un mittente per GX che pubblichi una di queste richieste circa ogni 30 secondi:
```
victron/R/YOUR_PORTAL_ID/keepalive            (empty payload)
```
o una richiesta di lettura:
```
victron/R/YOUR_PORTAL_ID/system/0/Serial     (empty payload)
```
Entrambe provocano la pubblicazione completa, terminando con N/YOUR_PORTAL_ID/full_publish_completed.

Controlla prima se ne esiste già uno. Node-RED, altre integrazioni Victron o automazioni esistenti spesso inviano già keepalive. Ascolta victron/R/YOUR_PORTAL_ID/# per un minuto: se arrivano richieste regolari, conserva quel mittente e non aggiungerne altri. Due mittenti raddoppiano le pubblicazioni senza vantaggi.

Se manca, usa un’automazione Home Assistant. Creane una e passa a Modifica in YAML e incolla con il tuo Portal ID e prefisso:
```
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
```
Non usare l’opzione suppress-republish keepalive (un payload keepalive come {"keepalive-options": ["suppress-republish"]}). Impedisce a GX di inviare full_publish_completed, necessario a Clevr, e i valori invariati possono scadere dopo 65 secondi.

Perché 30 secondi? GX accetta fino a 60, ma 30 permettono due pubblicazioni nella scansione di 130 secondi e mantengono i valori entro il limite di freschezza di 65 secondi.

Controlla il risultato ascoltando victron/N/YOUR_PORTAL_ID/full_publish_completed. Dovrebbe arrivare un messaggio ogni 30 secondi circa.
Configura l’integrazione Clevr Victron.
Quando il bridge funziona, installa o configura l’Clevr Victron Panel integrazione.

Quando chiede:

prefisso del bridge MQTT

inserisci:
```
victron/
```
Quando chiede:

GX Portal ID

inserisci il tuo Portal ID effettivo:
```
abcdef123456
```
Clevr cercherà sotto:
```
victron/N/abcdef123456/
```
Non invia nulla a victron/R/abcdef123456/: le richieste provengono dal mittente periodico.

La scansione attende fino a 130 secondi per due pubblicazioni complete; il mittente del passo 8 deve già essere attivo prima di aggiungere l’integrazione.

Comprendere il prefisso MQTT

Il prefisso Clevr deve corrispondere a quello presente sul broker MQTT Home Assistant, non necessariamente sul GX.

Ad esempio:

Topic visibili in Home Assistant	Prefisso MQTT Clevr
`victron/N/<portal>/...`	`victron/`
`gx/N/<portal>/...`	`gx/`
`energy/victron/N/<portal>/...`	`energy/victron/`
`N/<portal>/...`	lascia vuoto il prefisso

Per il bridge illustrato usa:

victron/

Se Home Assistant si collega direttamente al broker GX e vede topic che iniziano con:

N/<portal-id>/

lascia vuoto il prefisso Clevr.

Perché il keepalive è importante

L’MQTT attuale di Victron non usa messaggi retained per l’intero albero dispositivi.

Le applicazioni si iscrivono all’albero N/ e richiedono i dati attuali con:

R/<portal-id>/keepalive

GX ripubblica i dati disponibili. Victron documenta una scadenza di 60 secondi e consiglia aggiornamenti periodici mentre l’applicazione MQTT è attiva.

L’integrazione Clevr non invia keepalive. Ascolta solo i dati GX. Da 2.1.0-dev7 non invia richieste R/ né in configurazione né durante il funzionamento.

Serve quindi esattamente un mittente periodico per GX, circa ogni 30 secondi, come descritto nel passo 8. Senza mittente la scansione non trova pubblicazioni complete e i valori scadono. Con più mittenti GX pubblica troppo spesso.

Clevr non scrive impostazioni sul GX

La distinzione è importante.

Victron MQTT usa:

N/

per notifiche,

R/

per letture,

W/

per scritture. Secondo Victron queste richieste W/ possono modificare valori D-Bus e impostazioni operative.

L’integrazione Clevr Victron non richiede lo spazio W/ dei nomi.

La configurazione consigliata contiene:

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

ma deliberatamente non contiene:

topic W/# out

Fornisce un ulteriore livello di protezione sul bridge.

Anche se un altro client pubblica per errore su:

victron/W/...

del broker Home Assistant, nessuna regola illustrata permette di raggiungere GX.

La connessione Victron di Clevr è quindi progettata per monitoraggio e letture, non controllo delle impostazioni GX.

Risoluzione dei problemi

Problema	Cosa controllare
Integrazione MQTT non disponibile	Verifica che Mosquitto sia attivo
Il bridge non si connette	Verifica IP GX, accesso MQTT e porta permessa dal profilo di sicurezza
Non compaiono `victron/N/...` topic	Invia un `R/<portal>/keepalive`; i dati GX moderni non restano conservati per sempre
`N/` arrivano dati ma Clevr segnala «Nessun dato GX recente»	Verifica Portal ID e prefisso MQTT
Il keepalive non risponde	Verifica che la regola `R/` esista e punti da Home Assistant a GX
I topic iniziano con `N/...` anziché `victron/N/...`	Nessun prefisso locale; lascia vuoto il prefisso Clevr
I topic usano un altro prefisso	Inserisci il prefisso completo in Clevr
Porta 1883 rifiutata	Verifica la sicurezza GX; può servire MQTT sicuro su 8883
I dati appaiono e poi si fermano	Nessun mittente periodico o la regola `R/` non inoltra le richieste al GX
Clevr segnala “Nessun dato GX recente” o rileva solo parte del sistema	Verifica che un mittente invii keepalive ogni 30 secondi e arrivi `full_publish_completed` ; non usare `suppress-republish`
Pubblicazioni complete più frequenti di 30 secondi	Più mittenti attivi, ad esempio Node-RED e automazione HA; mantienine uno

Il risultato finale

Al termine Home Assistant deve avere un percorso MQTT bidirezionale di sola lettura verso 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

Non esiste volutamente un percorso per:

W/

Con MQTT funzionante, installa l’integrazione Clevr Victron Panel per Home Assistant. Usa la connessione MQTT esistente per rilevare sistema Victron, MPPT, rete, batterie e inverter FV AC supportati come Fronius.

Non servono credenziali MQTT aggiuntive in Clevr.

Prossimo passo: installa l’integrazione — vedi Collega Victron GX e Fronius a Home Assistant con l’integrazione Clevr Victron. Poi configura il tuo Clevr GX Panel.