MQTT

Publicar las lecturas en un broker propio y elegir entre los cinco formatos de mensaje.

La pestaña MQTT publica las mismas lecturas en cualquier broker. Atiende a quien alimenta un sistema distinto de Home Assistant, o a quien prefiere alimentar Home Assistant desde su propio broker.

Igual que en la integración nativa, la conexión va de tu móvil directamente a tu máquina, sin pasar por nuestros servidores.

  1. Introduce el broker

    Rellena Dirección del broker y Puerto. Si el broker exige autenticación, rellena también Usuario y Contraseña.

    Activa Usar TLS (SSL) cuando el broker esté expuesto fuera de tu red. Usar WebSocket y Ruta base atienden a brokers detrás de un proxy.

  2. Elige la versión del protocolo

    Los botones MQTT 3.1.1 y MQTT 5.0 seleccionan la versión. En caso de duda, elige la 3.1.1, que tiene una compatibilidad más amplia.

  3. Elige el formato

    Formato MQTT define el diseño de los temas y el formato de cada mensaje. Hay cinco opciones:

    • Home Assistant Discovery: con descubrimiento automático, las entidades se crean solas, con nombre, unidad e icono.
    • Homie 4.0: sigue la convención Homie.
    • Tópicos simples: un valor por tema, sin estructura adicional. El más sencillo de consumir desde un script.
    • JSON unificado: todo en un solo mensaje, en el tema que definas.
    • ThingsBoard: el formato de telemetría de ThingsBoard.

    Algunos formatos tienen ajustes propios, como Payload JSON (valor + timestamp) en los tópicos simples e Incluir timestamp en ThingsBoard.

  4. Define el prefijo de los temas

    Prefijo del tema es la raíz de todo lo que publica la app. Define el valor al principio y evita cambiarlo después, porque el cambio deja los temas antiguos huérfanos en el broker.

  5. Prueba antes de salir

    Toca Probar conexión. La prueba confirma dirección, puerto, TLS y credenciales antes de que actives la transmisión.

  6. Activa la transmisión y guarda

    Activa Activar transmisión, ajusta el Intervalo de transmisión y guarda con el botón flotante.

Si algo va mal

Revisa en este orden: la dirección y el puerto, si el móvil está en una red que alcanza el broker, si Usar TLS (SSL) se corresponde con lo que el broker espera, y si el usuario y la contraseña son correctos.

El puerto 1883 suele funcionar sin TLS, y el 8883, con TLS. Activar TLS en un puerto que no lo usa produce un fallo sin mensaje esclarecedor.

Elige el formato Home Assistant Discovery, el único con descubrimiento automático. En los demás formatos, las entidades hay que declararlas a mano.

Para Home Assistant, considera la integración nativa: es bidireccional, publica eventos en el bus y no necesita broker.

La app pregunta si quieres limpiar los temas del formato anterior. Si la respuesta fue mantenerlos, se quedan en el broker hasta que se quiten allí.

Para Home Assistant, la integración nativa ofrece más recursos: es bidireccional, publica eventos en el bus y no necesita broker.

El MQTT es la elección adecuada cuando ya mantienes un broker, cuando alimentas un sistema que no es Home Assistant, o cuando necesitas los datos en más de un destino a la vez.

← Todas las guíasEn el FAQ: Home Assistant y MQTT →