MQTT

Publicar as leituras em um broker próprio e escolher entre os cinco formatos de mensagem.

A seção MQTT publica as mesmas leituras em qualquer broker. Ela atende principalmente quem utiliza outras plataformas além do Home Assistant, como openHAB, Node-RED, Domoticz ou ThingsBoard, ou quem prefere alimentar o próprio Home Assistant via broker.

Assim como na integração nativa, os dados vão direto do celular para o seu broker.

  1. Informe o broker

    Preencha Endereço do Broker e Porta. Se o broker exigir autenticação, preencha também Usuário e Senha.

    Ative Usar TLS (SSL) quando o broker estiver exposto fora da sua rede. Usar WebSocket e Caminho Base atendem brokers atrás de proxy.

    O endereço, a porta, as opções de conexão e as credenciais ficam guardados apenas neste celular. Em outro celular da mesma conta, preencha de novo.

  2. Escolha a versão do protocolo

    Os botões MQTT 3.1.1 e MQTT 5.0 selecionam a versão. Na dúvida, escolha a 3.1.1, que tem compatibilidade mais ampla.

  3. Escolha o formato

    Formato MQTT define o desenho dos tópicos e o formato de cada mensagem. São cinco opções:

    • Home Assistant Discovery: com descoberta automática, as entidades são criadas sozinhas, com nome, unidade e ícone.
    • Homie 4.0: segue a convenção Homie.
    • Tópicos simples: um valor por tópico, sem estrutura adicional. O mais simples de consumir em um script.
    • JSON unificado: tudo em uma única mensagem, no tópico que você definir.
    • ThingsBoard: o formato de telemetria do ThingsBoard.

    Alguns formatos têm ajustes próprios, como Payload JSON (valor + timestamp) nos tópicos simples e Incluir timestamp no ThingsBoard.

  4. Defina o prefixo dos tópicos

    Prefixo do Tópico é a raiz de tudo o que o app publica. Defina o valor no início e evite alterá-lo depois, porque a mudança deixa os tópicos antigos órfãos no broker.

  5. Teste antes de sair

    Toque em Testar Conexão. O teste confirma endereço, porta, TLS e credenciais antes de você ativar a transmissão.

  6. Ative a transmissão e salve

    Ative Ativar transmissão, ajuste o Intervalo de transmissão e salve pelo botão flutuante.


← Todos os guiasNo FAQ: Home Assistant e MQTT →