Home Assistant sensor de presença: detecção confiável passo a passo

São 19h40, a sala de reuniões do segundo andar está vazia há duas horas e o ar-condicionado continua ligado porque o Home Assistant ainda acredita que há duas pessoas lá dentro. Ou o contrário: quatro pessoas sentadas quietas em uma apresentação, o PIR deixa de ver movimento e a luz apaga no meio do slide. Quem já configurou um home assistant sensor de presença em um prédio real conhece os dois cenários. O problema não é o Home Assistant nem o sensor em si — é tratar um estado binário de movimento como se fosse presença, e tratar um contador de pessoas como se fosse infalível. Este artigo mostra como combinar os dois para obter uma detecção de presença que aguenta meses em produção sem ninguém precisar reiniciar nada.

Por que o PIR sozinho não é presença

Um sensor PIR detecta mudança de calor em movimento. Pessoa parada digitando, lendo ou assistindo a uma reunião não gera evento. O sensor volta a "desligado" após o tempo de retenção do próprio dispositivo, e a automação conclui que a sala esvaziou. Sensores de radar mmWave reduzem esse falso negativo, mas introduzem o inverso: ventiladores, cortinas e até o fluxo de ar do difusor podem manter o estado em "ligado". Em ambos os casos você tem um sinal útil como confirmação de atividade, não como fonte única de verdade.

Um sensor de contagem de pessoas com IA na porta resolve o lado da ocupação: ele sabe quantas pessoas entraram e saíram, independentemente de estarem se mexendo. O que ele não sabe é quando errou — duas pessoas lado a lado contadas como uma, alguém que saiu pela porta de emergência sem sensor. Por isso a estratégia que funciona é usar a contagem como estado principal e o sensor de atividade como verificação cruzada. Se quiser entender o contexto mais amplo de arquitetura antes dos detalhes, veja o guia completo de integração de ocupação com Home Assistant; aqui o foco é só presença.

Home assistant sensor de presença: a lógica em cinco passos

A sequência abaixo assume que a contagem já chega ao Home Assistant via MQTT, com um tópico por zona (por exemplo predio/andar2/sala_reunioes/contagem), mensagens retidas e QoS 1. Plataformas como o VemSpace publicam contagem validada por zona; sensores de IA com processamento local também podem publicar diretamente no broker.

• 1. Crie uma entidade de contagem por zona. Use MQTT Discovery ou configure um sensor MQTT manual com unidade "pessoas" e state_class: measurement. Não pule a definição de availability_topic: se o sensor cair, a entidade deve ficar "indisponível" em vez de congelar no último valor. Presença baseada em um número congelado é a causa mais comum de ar-condicionado ligado a noite inteira.
• 2. Construa um binary_sensor template de presença. A regra base é simples: contagem maior que zero significa ocupado. Defina device_class: occupancy para que painéis e integrações de voz interpretem o estado corretamente. Adicione delay_off de dois a cinco minutos para evitar que uma pessoa saindo e voltando com o café derrube o estado.
• 3. Cruze com o sensor de atividade. Estenda o template: a zona está ocupada se a contagem for maior que zero ou se o PIR/mmWave reportou movimento nos últimos N minutos. Isso cobre o caso em que a contagem zerou por erro mas há alguém claramente lá. O inverso — contagem maior que zero sem nenhum movimento por mais de 45 ou 60 minutos — é o sinal de que a contagem derivou e deve disparar uma correção, não manter a presença.
• 4. Separe presença de intensidade. O binary_sensor responde à pergunta "há alguém?". Para o ar-condicionado e a ventilação você precisa de outra pergunta: "quantos?". Crie um sensor template com bandas de ocupação (0, 1–5, 6–15, 16+) e exija um tempo mínimo em cada banda antes de mudar o setpoint. Nunca ligue a contagem crua diretamente ao equipamento; uma sala oscilando entre 9 e 11 pessoas não pode fazer o sistema alternar de modo a cada minuto.
• 5. Escreva as automações contra o binary_sensor, não contra a contagem. Luz, standby de telas e sinalização de "sala em uso" consomem a entidade de presença. Climatização consome a banda. Alertas de lotação usam um gatilho numérico acima do limite com condição de duração mínima — 60 segundos filtra picos de passagem na porta.

Rotina de reposição: o passo que ninguém documenta

Sensores de entrada e saída acumulam erro ao longo do dia. Ao final de oito horas a zona pode "ter" duas ou três pessoas fantasma, e o sensor de presença home assistant que você montou passará a noite reportando ocupado. A correção prática tem duas partes.

A primeira é uma automação de reposição a zero fora do horário de funcionamento, condicionada ao estado do alarme de intrusão: se o alarme está armado em modo "ausente", o prédio está comprovadamente vazio e todas as contagens podem ser zeradas sem risco. Publicar o zero no tópico MQTT com mensagem retida garante que o estado sobrevive a um reinício do Home Assistant.

A segunda é uma reposição por zona durante o dia, acionada pela regra do passo 3: contagem positiva sem nenhum movimento por um período longo. Em vez de zerar imediatamente, registre o evento em um contador de inconsistências por zona. Se uma sala acumula várias correções por semana, o problema está no posicionamento do sensor ou em uma saída não monitorada — e isso se resolve na planta, não no YAML. Em prédios com segurança noturna e equipe de limpeza, a exclusão de pessoal disponível em sensores de IA evita que um vigilante em ronda mantenha a presença ativa em um auditório vazio às 23h.

O que esperar de precisão na prática

Com sensores de IA bem posicionados, a Vemco garante contratualmente um mínimo de 96% de precisão na contagem, chegando tipicamente a 98–99% quando iluminação, disposição do espaço e comportamento das pessoas permitem. Para detecção de presença isso é mais do que suficiente, desde que a rotina de reposição exista: um erro de 2% em 200 passagens diárias é algo em torno de quatro contagens erradas por dia, pequeno o bastante para a verificação cruzada com o sensor de atividade absorver e a reposição noturna eliminar. Sem a rotina, esse mesmo erro vira presença fantasma permanente.

Valide antes de automatizar. Durante pelo menos uma semana de operação normal, compare a contagem de cada zona com contagens manuais em três momentos do dia e registre em quais zonas o binary_sensor de presença discordou da realidade. Só depois ligue climatização e iluminação às entidades. Quando o projeto cresce para dezenas de zonas com integração a BMS e requisitos de auditoria, o padrão que vemos funcionar é o VemFusion fazendo a ponte direta com AVAC e segurança, e o Home Assistant mantendo a lógica local e os casos de uso experimentais.

Perguntas frequentes

Posso usar só um sensor mmWave como detecção de presença no Home Assistant?
Para uma sala pequena com uma única entrada e uso residencial, muitas vezes sim. Em escritórios, salas de aula ou qualquer espaço onde a automação depende de quantas pessoas há, o mmWave não entrega número e sofre com falsos positivos de ventilação; use-o como confirmação de atividade junto a um contador.

Com que frequência devo zerar as contagens?
Uma vez por dia fora do horário de funcionamento, condicionada ao alarme armado, é o mínimo. Zonas que acumulam inconsistências ao longo do dia devem ter correção adicional baseada em ausência prolongada de movimento, e o histórico dessas correções indica onde o sensor precisa ser reposicionado.

O que acontece com a presença se o sensor de contagem ficar offline?
Se você configurou o tópico de disponibilidade, a entidade fica "indisponível" e o template de presença deve tratar esse estado explicitamente — por exemplo, recorrendo apenas ao sensor de atividade até a contagem voltar. Sem esse tratamento, o Home Assistant mantém o último valor e a presença congela.

Está montando detecção de presença por zona e quer definir onde posicionar os sensores de contagem, como estruturar os tópicos e quais regras de correção fazem sentido para o seu prédio? A equipe da Vemco desenha arquiteturas de contagem e ocupação desde 2005. Fale conosco em vemcogroup.com/contact-us e traga a planta do edifício — é por ela que começamos.