Controle de espaços
MQTT: mensagens, estado e disponibilidade em uma interface AV
O MQTT pode levar informações de um dispositivo a uma plataforma AV por meio de um broker que distribui mensagens. Antes de escolher uma integração, defina qual dado precisa, quem o publica e como identificar que ele deixou de ser atualizado.
Quem publica e quem interpreta
O dispositivo ou serviço publica uma mensagem em um topic, um nome que organiza as informações. O broker a distribui aos clientes com assinaturas correspondentes. A aplicação define o conteúdo da mensagem, ou payload; dois produtos com MQTT não necessariamente entendem os mesmos nomes ou valores.
Registre as versões do protocolo, firmware, broker e plataforma. Este guia usa como referência MQTT 5.0, padrão OASIS de 7 de março de 2019, e a documentação MQTT do Home Assistant com cabeçalho 2026.10.4 na consulta. Não presuma essa combinação em uma instalação existente.
Exemplo de leitura com nomes e valores fictícios
Suponha que uma plataforma receba informações ambientais para mostrar junto ao estado AV. Os topics abaixo apenas ilustram a separação dos conceitos; não são endereços de uma instalação nem uma configuração para copiar.
- Dispositivo/serviço → topic e payload documentados.
- Broker → distribuição à plataforma assinante.
- Interface AV → valor interpretado e aviso de falta de atualização.
| Topic de exemplo | Payload de exemplo | O que representa |
|---|---|---|
| demo/espacio/temperatura | 23.4 | Leitura interpretada em °C somente se essa unidade for combinada com o publicador. |
| demo/espacio/disponibilidad | online | Disponibilidade do publicador conforme sua implementação. |
| demo/espacio/medicion_hora | 10:30:00 | Horário fictício: um projeto real precisa de data, fuso e relógio de referência. |
Retido não significa recém-medido
Uma mensagem retained pode entregar o último valor armazenado quando um cliente assina o topic. Isso ajuda a recuperar uma indicação, mas não comprova uma nova medição. No MQTT 5.0, Message Expiry Interval pode limitar a vida da mensagem; também é preciso definir o que a interface faz com um valor já recebido.
Como exemplo de plataforma, MQTT Sensor do Home Assistant diferencia state_topic, availability_topic e expire_after. A documentação alerta que um estado retido pode reaparecer após reiniciar ou recarregar e fazer um dado vencido voltar a parecer disponível. Confira os critérios de atualização conforme a publicação real.
Entrega da mensagem e confirmação do equipamento
Os níveis QoS descrevem a entrega de mensagens MQTT, não o resultado AV. QoS 1 permite duplicatas e QoS 2 evita a entrega duplicada dentro da troca de protocolo; nenhum deles comprova que o projetor esteja pronto ou que haja imagem.
A disponibilidade exige um mecanismo definido pelo dispositivo ou serviço. Mensagens de início e Last Will podem ajudar a informar conexão ou desconexão, mas sua configuração e seus tempos precisam ser verificados. Um broker ou uma plataforma online não confirma o estado de todos os equipamentos.
O que compartilhar para avaliar a integração
Comece pelas informações que quer visualizar e por um esquema dos equipamentos. Para avançar, combine quem mantém o broker, quem define as mensagens e quem conserva o comando AV manual. O escopo é de informações e coordenação não críticas; exclui funções de segurança, controle de acesso e máquinas.
- Modelos, firmware e versões MQTT dos dispositivos conhecidos.
- Documentação de topics, payloads, unidades e disponibilidade, sem credenciais.
- Critério de dado desatualizado e comportamento após reconexão.
- Dependências locais, de conta ou de Internet e retorno AV necessário.
Perguntas que ajudam na escolha
Preciso de um broker na Internet?
O MQTT não exige um broker na Internet. Sua localização e dependências são escolhidas conforme a plataforma e o projeto; a continuidade da solução precisa de verificação própria.
Posso mostrar o último valor enquanto a conexão volta?
Você pode definir essa exibição, mas ela precisa diferenciar o último valor conhecido de uma leitura atual. Combine como indicar sua idade e quando ele passa a indisponível.
MQTT torna qualquer dispositivo compatível com minha plataforma?
Não. É preciso analisar o formato das mensagens e as funções das duas partes. Pode ser necessário um gateway ou uma tradução documentada; compartilhar o transporte não basta.