Como Implementar a Integração de Ocupação no Home Assistant

A maioria das integrações de ocupação no Home Assistant falha por uma razão que raramente aparece nos tutoriais: as equipas tratam presença binária e contagem de pessoas como se fossem a mesma coisa. Um sensor PIR que diz "alguém está na sala" serve para acender uma luz. Não serve para decidir se o AVAC deve trabalhar a 30% ou a 80% da capacidade, nem para disparar um alerta quando uma sala de conferências ultrapassa o limite legal de lotação. Quem gere edifícios reais precisa de números, não de estados ligado/desligado — e é exatamente aí que a integração de ocupação no Home Assistant se torna um projeto de engenharia de dados, não apenas de automação doméstica.

Comece pela pergunta certa: presença ou contagem?

Antes de escolher hardware ou escrever uma única automação em YAML, defina o caso de uso. Presença binária resolve iluminação e standby de equipamentos. Contagem contínua resolve ventilação por demanda, alertas de lotação, otimização de limpeza e decisões de portefólio imobiliário. A Vemco, que trabalha com dados de ocupação desde 2005, vê este erro repetir-se em escritórios, universidades e edifícios públicos: instala-se deteção de movimento e depois pede-se ao sistema respostas que só a contagem consegue dar.

Se o objetivo é cortar o desperdício de sistemas sempre ligados — o cenário típico em campus universitários e repartições públicas — precisa de sensores de IA com contagem real e, idealmente, com exclusão de pessoal, para que seguranças e equipas de limpeza não mantenham o AVAC de um auditório vazio a funcionar às 23h.

Arquitetura de referência: três camadas, um broker

Uma integração de ocupação no Home Assistant que aguenta produção assenta em três camadas claras:

• Camada de sensores: sensores de IA nos pontos de entrada e zonas críticas, com processamento no dispositivo. Evite depender de vídeo bruto na rede — pesa na largura de banda e complica a conformidade com o RGPD.
• Camada de transporte: MQTT como espinha dorsal. Publique contagens por zona em tópicos estruturados, por exemplo edificio/piso2/sala_reunioes/contagem, com QoS 1 e mensagens retidas para que o Home Assistant recupere o estado após um reinício.
• Camada de decisão: entidades no Home Assistant via MQTT Discovery, sensores template para agregações por piso ou edifício, e automações com condições de histerese.

Plataformas como o VemSpace fornecem a contagem validada e a análise de utilização de espaços; o Home Assistant consome esses dados via API ou MQTT e executa a lógica local. Para instalações maiores, o VemFusion faz a ponte direta entre os dados de ocupação e o AVAC, o BMS e a segurança — o Home Assistant pode então funcionar como camada de orquestração adicional ou como ambiente de prototipagem antes de escalar.

Implementação passo a passo

Com a arquitetura definida, a sequência que recomendamos a integradores é esta:

• 1. Mapeie as zonas e os fluxos. Cada porta, corredor de passagem obrigatória e ponto cego. A precisão da contagem depende mais do posicionamento do que do sensor em si.
• 2. Instale o broker MQTT (Mosquitto como add-on ou instância dedicada) e defina a convenção de tópicos antes de ligar o primeiro sensor. Renomear tópicos com 40 sensores em produção é uma tarde perdida.
• 3. Crie as entidades de contagem no Home Assistant e valide-as contra contagens manuais durante pelo menos uma semana de operação normal.
• 4. Construa sensores template para métricas derivadas: taxa de ocupação por zona, percentagem da lotação máxima, ocupação agregada por piso.
• 5. Só depois escreva as automações — ventilação por demanda, iluminação por zona, alertas de limite e rotinas de fim de dia.

Para alertas de lotação, o padrão maduro é o que a Vemco usa nas suas soluções de ocupação em tempo real: um limite predefinido por zona que dispara notificações quando é atingido. No Home Assistant, isso traduz-se numa automação com gatilho numérico acima do limite, condição de duração mínima (por exemplo, 60 segundos, para filtrar picos de passagem) e ações em cascata — notificação à equipa de facilities, sinalização no local e, se necessário, comando ao controlo de acessos.

O detalhe que separa pilotos de sistemas em produção

Uma observação de quem já implementou isto várias vezes: o problema número um em produção não é a deteção, é o drift de contagem. Sensores de entrada/saída acumulam erro ao longo do dia — duas pessoas a entrar lado a lado contadas como uma, alguém que sai por uma porta de emergência não monitorizada. Ao fim de oito horas, a zona "tem" três pessoas fantasma e o AVAC continua a trabalhar para elas. A solução prática: uma automação de reposição a zero fora do horário de funcionamento, cruzada com o estado do alarme de intrusão como verificação de que o edifício está realmente vazio. Sem esta rotina, qualquer automação baseada em contagem degrada-se silenciosamente.

O segundo detalhe é a histerese no AVAC. Nunca ligue a contagem diretamente ao setpoint. Uma sala de reuniões que oscila entre 9 e 11 pessoas não pode fazer o sistema de ventilação alternar de modo a cada minuto — isso encurta a vida dos equipamentos e irrita os ocupantes. Use bandas de ocupação (0, 1–5, 6–15, 16+) com tempos mínimos de permanência em cada estado.

Precisão: o que pode prometer ao cliente

Seja honesto nos números. Com sensores de IA bem posicionados, a Vemco garante contratualmente um mínimo de 96% de precisão na contagem, atingindo tipicamente 98–99% quando as condições — iluminação, disposição do espaço e comportamento dos visitantes — o permitem. Desconfie de quem promete 99% garantidos em qualquer cenário: uma entrada com contraluz forte ou grupos compactos em hora de ponta afetam qualquer tecnologia. O que importa para as automações é que o erro seja pequeno, conhecido e corrigido diariamente pela rotina de reposição.

Quando o Home Assistant chega ao limite

O Home Assistant é excelente para prototipagem, edifícios de dimensão média e equipas que querem controlo total da lógica. Mas quando o projeto envolve dezenas de zonas, integração certificada com BMS existentes, requisitos de auditoria ou SLA de disponibilidade, a arquitetura híbrida vence: contagem validada e análise de utilização no VemSpace, integração com AVAC, BMS e segurança através do VemFusion, e o Home Assistant reservado para a lógica local e os casos de uso experimentais. Universidades e edifícios públicos que seguiram este caminho conseguiram cortar de forma mensurável o desperdício de sistemas que antes funcionavam em contínuo, independentemente de haver alguém no espaço.

Está a planear uma integração de ocupação — seja um piloto com Home Assistant ou um projeto multi-edifício com ligação ao BMS? A equipa da Vemco desenha arquiteturas de contagem desde 2005 e pode ajudá-lo a definir zonas, escolher sensores e estruturar os dados antes de investir em hardware. Fale connosco em vemcogroup.com/contact-us e traga a planta do seu edifício — é por aí que começamos.