MQTT

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

A aba MQTT publica as mesmas leituras em qualquer broker. Ela atende quem alimenta um sistema diferente do Home Assistant, ou quem prefere abastecer o Home Assistant pelo próprio broker.

Assim como na integração nativa, a conexão vai do seu celular diretamente para a sua máquina, sem passar pelos nossos servidores.

  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.

  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.

Se algo der errado

Confira nesta ordem: o endereço e a porta, se o celular está em uma rede que alcança o broker, se Usar TLS (SSL) corresponde ao que o broker espera, e se o usuário e a senha estão corretos.

A porta 1883 costuma operar sem TLS, e a 8883, com TLS. Ativar TLS em uma porta que não o utiliza produz uma falha sem mensagem esclarecedora.

Escolha o formato Home Assistant Discovery, o único com descoberta automática. Nos demais formatos, as entidades precisam ser declaradas manualmente.

Para Home Assistant, considere a integração nativa: ela é bidirecional, publica eventos no barramento e dispensa broker.

O app pergunta se deseja limpar os tópicos do formato anterior. Se a resposta foi manter, eles permanecem no broker até serem removidos por lá.

Para Home Assistant, a integração nativa oferece mais recursos: é bidirecional, publica eventos no barramento e dispensa broker.

O MQTT é a escolha adequada quando você já mantém um broker, quando alimenta um sistema que não é Home Assistant, ou quando precisa dos dados em mais de um destino ao mesmo tempo.

← Todos os guiasNo FAQ: Home Assistant e MQTT →