Conecta Home Assistant MQTT a Victron GX: configura el puente N/R MQTT

Actualizado el 26 de septiembre de 2026 (Clevr Victron 2.1.0-dev7): las versiones anteriores indicaban que Clevr enviaba keepalive automáticamente. No lo hace. La integración solo escucha. Ahora necesitas exactamente un emisor periódico por GX que solicite una publicación completa cada 30 segundos — consulta paso 8. Si usas 2.1.0-dev5 con keepalive gestionado por Home Assistant, añade el emisor antes de actualizar.

La integración Clevr Victron para Home Assistant lee información Victron y Fronius mediante MQTT.

No crea una conexión MQTT propia al Cerbo GX u otro GX. Utiliza la integración MQTT ya configurada en Home Assistant.

Para funcionar, el broker de Home Assistant debe:

recibir el árbol Victron N/ de notificaciones del GXy devolver solicitudes R/ keepalive o de lectura al GX, para que un emisor periódico mantenga la publicación de datos.

La integración Clevr solo escucha. No envía solicitudes R/ ni comandos W/ de escritura y no modifica ajustes Victron mediante MQTT.

Esta guía muestra cómo configurar la conexión.

Cómo funciona la conexión MQTT

Una instalación típica Clevr tiene este aspecto:

             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

También hay tráfico en sentido contrario:

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

La victron/ en este ejemplo es un prefijo local del puente. Los temas reales del GX siguen empezando por N/ y R/.

La implementación MQTT actual de Victron usa N/ para notificaciones, R/ para lecturas y W/ para solicitudes que pueden cambiar valores D-Bus.

Para Clevr solo necesitamos:

Espacio de nombres MQTT	Dirección	Finalidad
`N/`	GX → Home Assistant	Mediciones e información de equipos
`R/`	Home Assistant → GX	Solicitudes de lectura y keepalive
`W/`	No enlazado	Cambios de ajustes Victron — no requeridos por Clevr

Esta separación es intencionada.

¿Por qué usar un puente MQTT?

Muchas instalaciones ya usan MQTT para ESPHome, pasarelas Zigbee, contadores, sensores y otras automatizaciones.

Home Assistant debe seguir usando su broker habitual.

En lugar de cambiar al broker GX, conectamos ambos mediante un puente Mosquitto.

El resultado es sencillo:

GX topic:

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

becomes in Home Assistant:

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

En sentido contrario:

Home Assistant publishes:

victron/R/abcdef123456/keepalive

GX receives:

R/abcdef123456/keepalive

Mosquitto admite esta reasignación de temas mediante prefijos locales y remotos.

Instalación paso a paso

Activa el acceso MQTT en Victron GX.
El GX debe permitir conexiones MQTT desde la red local.

Venus OS moderno usa FlashMQ. Victron documenta el broker GX en el puerto TCP 1883 y/o 8883, según la seguridad de red del equipo.

Revisa MQTT y el acceso local en Cerbo GX u otro GX.

Anota la IP del GX. Recomendamos una reserva DHCP o IP estática para evitar cambios inesperados.

También necesitarás el VRM Portal ID del GX.

Victron identifica cada instalación MQTT por este Portal ID, por ejemplo:
```
N/abcdef123456/system/0/Ac/Grid/L1/Power
```
En este ejemplo:
```
abcdef123456
```
es el Portal ID.

Victron indica que el Portal ID está en los ajustes VRM del GX.
Instala Mosquitto en Home Assistant.
Si ya usas MQTT, normalmente puedes omitir este paso.

En Home Assistant OS abre:

Ajustes → Aplicaciones → Instalar aplicación

e instala:

Broker Mosquitto

Inicia Mosquitto tras instalarlo.

Home Assistant recomienda su broker oficial Mosquitto como opción local más sencilla. MQTT suele detectarlo automáticamente.

Después comprueba:

Ajustes → Dispositivos y servicios → MQTT

La integración MQTT debe aparecer conectada.

También se admite un servidor MQTT independiente. Debe ser el mismo broker que usa la integración MQTT de Home Assistant.
Activa archivos de configuración Mosquitto personalizados.
Abre la configuración de Broker Mosquitto en la aplicación.

Activa la configuración personalizada:
```
customize:
  active: true
  folder: mosquitto
```
La aplicación oficial leerá archivos adicionales .conf desde:
```
/share/mosquitto/
```
Este mecanismo lo proporciona la aplicación oficial Mosquitto.

Crea el puente Victron.

Crea:

/share/mosquitto/victron.conf

Configuración recomendada:

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

Sustituye:

192.168.1.50

por la IP de tu GX.

Sustituye:

YOUR_PORTAL_ID

por el Portal ID real de tu instalación.

Por ejemplo:

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

Las dos topic reglas son lo importante.

Esta regla:

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

se suscribe a este árbol del GX:

N/abcdef123456/#

y lo coloca en el broker de Home Assistant bajo:

victron/N/abcdef123456/#

La segunda regla:

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

hace lo contrario para las lecturas.

Un mensaje publicado localmente en:

victron/R/abcdef123456/keepalive

se envía al GX como:

R/abcdef123456/keepalive

Observa que deliberadamente no hay W/ regla de puente.

Reinicia el broker Mosquitto.
Reinicia Mosquitto después de crear o modificar victron.conf.

Revisa el registro al arrancar.

No deberían repetirse errores de conexión del puente victron-gx en el registro.

Si el GX no acepta conexiones en el puerto 1883revisa la seguridad de red. Venus OS actual puede ofrecer MQTT en el puerto 8883 con SSL/TLS según el perfil de seguridad.

No reduzcas la seguridad para hacer funcionar el ejemplo. Si el GX solo permite MQTT seguro, configura la conexión TLS del puente.
Prueba la dirección N/ de comunicación.
En Home Assistant abre:

Ajustes → Dispositivos y servicios → MQTT → Configurar

Busca Escuchar un tema.

Introduce:
```
victron/N/YOUR_PORTAL_ID/#
```
y empieza a escuchar.

Al principio quizá veas poco o nada.

Es normal.

Venus OS moderno ya no publica el árbol completo como mensajes retenidos. Un cliente conectado debe solicitar actualización mediante keepalive Victron.
Prueba la dirección R/ con un keepalive.
Mantén la escucha del tema activa.

En la configuración MQTT publica un paquete en:
```
victron/R/YOUR_PORTAL_ID/keepalive
```
con contenido vacío.

El puente elimina el prefijo victron/ y el GX recibe:
```
R/YOUR_PORTAL_ID/keepalive
```
El GX debe publicar sus datos actuales.

En Home Assistant deben aparecer mensajes como:
```
victron/N/YOUR_PORTAL_ID/system/0/...
```
```
victron/N/YOUR_PORTAL_ID/solarcharger/...
```
```
victron/N/YOUR_PORTAL_ID/pvinverter/...
```
y otros dispositivos instalados.

Al terminar una actualización completa, Venus OS reciente también publica:
```
N/YOUR_PORTAL_ID/full_publish_completed
```
Victron recomienda el mecanismo R/<portal-id>/keepalive para solicitar el árbol MQTT actual.
Configura un único emisor periódico de publicaciones completas.
El GX solo republica su árbol completo cuando se solicita. Ni Clevr ni el panel lo solicitan: debe hacerlo otro componente de la instalación.

Configurar exactamente un emisor por GX que publique una de estas solicitudes aproximadamente cada 30 segundos:
```
victron/R/YOUR_PORTAL_ID/keepalive            (empty payload)
```
o una solicitud de lectura:
```
victron/R/YOUR_PORTAL_ID/system/0/Serial     (empty payload)
```
Ambas provocan la publicación completa, terminando en N/YOUR_PORTAL_ID/full_publish_completed.

Comprueba primero si ya existe uno. Node-RED, otras integraciones Victron o automatizaciones existentes suelen enviar keepalive. Escucha victron/R/YOUR_PORTAL_ID/# durante un minuto: si llegan solicitudes regulares, conserva ese emisor y no añadas otro. Dos emisores duplican las publicaciones sin beneficio.

Si no existe, lo más sencillo es una automatización Home Assistant. Crea una y cambia a Editar en YAML y pega lo siguiente con tu Portal ID y prefijo:
```
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
```
No uses la opción suppress-republish de keepalive (un contenido keepalive como {"keepalive-options": ["suppress-republish"]}). Impide que GX envíe full_publish_completed, que Clevr necesita, y los valores constantes del panel pueden caducar a los 65 segundos.

¿Por qué 30 segundos? GX admite hasta 60, pero 30 permiten dos publicaciones completas durante el escaneo de 130 segundos y mantienen los valores dentro del límite de vigencia de 65 segundos.

Comprueba el resultado escuchando victron/N/YOUR_PORTAL_ID/full_publish_completed. Debe llegar un mensaje cada 30 segundos aproximadamente.
Configura la integración Clevr Victron.
Con el puente funcionando, instala o configura la Clevr Victron Panel integración.

Cuando solicite:

prefijo del puente MQTT

introduce:
```
victron/
```
Cuando solicite:

GX Portal ID

introduce tu Portal ID real:
```
abcdef123456
```
Clevr buscará bajo:
```
victron/N/abcdef123456/
```
No envía nada a victron/R/abcdef123456/: las solicitudes proceden del emisor periódico.

El escaneo espera hasta 130 segundos dos publicaciones completas; el emisor del paso 8 debe estar activo antes de añadir la integración.

Comprende el prefijo MQTT

El prefijo Clevr debe coincidir con lo existente en el broker MQTT de Home Assistant, no necesariamente en el GX.

Por ejemplo:

Temas visibles en Home Assistant	Prefijo MQTT Clevr
`victron/N/<portal>/...`	`victron/`
`gx/N/<portal>/...`	`gx/`
`energy/victron/N/<portal>/...`	`energy/victron/`
`N/<portal>/...`	deja el prefijo vacío

Para el puente mostrado, usa:

victron/

Si Home Assistant conecta directamente al broker GX y ve temas que empiezan por:

N/<portal-id>/

deja vacío el prefijo Clevr.

Por qué importa el keepalive

El MQTT actual de Victron no depende de mensajes retenidos para el árbol completo.

Las aplicaciones se suscriben al árbol N/ y solicitan datos actuales con:

R/<portal-id>/keepalive

El GX vuelve a publicar los datos disponibles. Victron documenta un tiempo límite de 60 segundos y recomienda renovarlo periódicamente mientras MQTT esté activo.

La integración Clevr no envía keepalive. Solo escucha los datos del GX. Desde 2.1.0-dev7 no envía solicitudes R/ ni al configurar ni durante el funcionamiento.

Por tanto, necesitas exactamente un emisor periódico por GX, cada 30 segundos aproximadamente, como se explica en paso 8. Sin emisor no se detecta una publicación completa y los valores caducan. Con varios, GX republica más de lo necesario.

Clevr no escribe ajustes en el GX

Esta distinción es importante.

Victron MQTT utiliza:

N/

para notificaciones,

R/

para lecturas,

W/

para escrituras. Según Victron, estas solicitudes W/ pueden modificar valores D-Bus y ajustes de funcionamiento.

La integración Clevr Victron no necesita el espacio W/ de nombres.

La configuración recomendada contiene:

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

pero deliberadamente no incluye:

topic W/# out

Aporta protección adicional en el propio puente.

Aunque otro cliente publique por error en:

victron/W/...

del broker Home Assistant, ninguna regla mostrada permite llegar al GX.

Por tanto, la conexión Victron de Clevr se centra en supervisión y lecturas, no control de ajustes GX.

Solución de problemas

Problema	Qué comprobar
Integración MQTT no disponible	Comprueba que Mosquitto esté funcionando
El puente no conecta	Verifica IP GX, acceso MQTT y puerto permitido por el perfil de seguridad
No aparecen `victron/N/...` temas	Envía un `R/<portal>/keepalive`; los datos GX modernos no se retienen indefinidamente
`N/` llegan datos, pero Clevr indica «Sin datos GX recientes»	Comprueba Portal ID y prefijo MQTT
El keepalive no responde	Comprueba que la regla `R/` exista y vaya de Home Assistant al GX
Los temas empiezan por `N/...` en vez de `victron/N/...`	La conexión no tiene prefijo local; deja vacío el prefijo Clevr
Los temas usan otro prefijo	Introduce el prefijo completo en Clevr
Puerto 1883 rechazado	Revisa la seguridad GX; quizá requiera MQTT seguro en 8883
Los datos aparecen y se detienen	No hay emisor periódico o la regla `R/` no transmite sus solicitudes al GX
Clevr indica “Sin datos GX recientes” o detecta solo parte del sistema	Comprueba que un emisor envíe keepalive cada 30 segundos y llegue `full_publish_completed` ; no uses `suppress-republish`
Publicaciones completas más frecuentes que cada 30 segundos	Hay varios emisores, como Node-RED y una automatización HA; deja solo uno

El resultado final

Al terminar, Home Assistant debe tener un recorrido MQTT bidireccional de solo lectura hacia 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

No existe deliberadamente un recorrido para:

W/

Con MQTT funcionando, instala la integración Clevr Victron Panel para Home Assistant. Usa la conexión MQTT existente para detectar el sistema Victron, MPPT, red, baterías e inversores PV AC compatibles como Fronius.

No hace falta introducir credenciales MQTT adicionales en Clevr.

Siguiente paso: instala la integración — consulta Conecta Victron GX y Fronius a Home Assistant con la integración Clevr Victron. Después configura tu Clevr GX Panel.