Gatilho por Valor Numérico

A automação dispara quando a leitura deixa uma região igual ou inferior ao limite e passa para uma região superior. Um exemplo é ligar a ventilação quando a concentração de CO₂ cruza 1.000 ppm. O cruzamento deve ser definido com unidade, qualidade do sensor e frequência de atualização conhecidas. Se o sensor publica 995, 1005, 998 e 1007 ppm em poucos segundos, uma regra sem histerese ou bloqueio pode gerar múltiplas execuções. A ação também pode alterar a própria variável, como um ventilador que reduz CO₂ ou temperatura, criando ciclos rápidos. Para evitar, usam-se limiares separados de ligar e desligar, tempo mínimo ligado e confirmação temporal. O gatilho deve considerar estados unknown, unavailable, null e erros de conversão para não interpretar retorno de falha como valor real.

A regra inicia quando a grandeza passa de uma região igual ou superior ao limite para uma região inferior. É comum em monitoramento de bateria, potência, nível de reservatório e luminosidade. Uma tomada pode indicar potência abaixo de 3 W durante 5 min e sinalizar que a máquina terminou. O valor isolado, porém, pode ocorrer durante pausas normais do ciclo. A duração reduz falso positivo, mas também aumenta atraso. Para baterias, a tensão pode recuperar após retirada de carga e cruzar o limiar em ambos os sentidos. Para iluminação, nuvens e sombras provocam oscilações. A escolha precisa usar comportamento histórico, resolução do sensor e consequência da ação. Em sistemas críticos, o gatilho deve criar alerta e não desligar equipamento sem confirmação independente.

Algumas plataformas permitem disparar quando um valor entra numa janela, sai dela ou satisfaz simultaneamente condições acima e abaixo. Uma automação pode considerar umidade confortável entre 40% e 60% UR, tensão dentro de 210–240 V ou temperatura de armazenamento entre 2 e 8 °C. A semântica precisa ser explícita: entrar na faixa, permanecer nela e sair da faixa são eventos distintos. Limites inclusivos ou exclusivos também mudam o comportamento em valores exatamente iguais. Sensores com resolução de 1 unidade podem nunca publicar valores intermediários esperados. Se a plataforma avalia apenas cada atualização recebida, saltar de 39 para 61 atravessa a faixa sem registrar entrada. Para eventos importantes, a lógica deve verificar cruzamento matemático ou usar estados derivados.

O valor observado pode estar em um atributo, e não no estado principal da entidade. Uma câmera pode expor temperatura interna, um inversor pode publicar potência por fase e uma bateria pode apresentar state_of_charge enquanto o estado principal permanece charging. O gatilho precisa apontar o caminho correto e tratar ausência do atributo após reinício ou atualização de firmware. Integrações podem mudar nomes, unidades ou tipos. Um número enviado como texto exige conversão; uma string vazia não deve virar zero. Antes de implantar, convém registrar exemplos reais do payload, validar unidade e testar atualização. A vantagem é reagir a dados específicos sem criar sensores auxiliares. A desvantagem é maior acoplamento ao schema da integração.

O disparo ocorre somente se a relação numérica permanecer verdadeira por um período, como temperatura acima de 30 °C por 10 min ou consumo abaixo de 5 W por 3 min. A duração funciona como filtro temporal e reduz reação a picos. Ela não é equivalente a média móvel: um único valor de retorno à região normal pode reiniciar o contador, mesmo que a média continue alta. Reinícios do controlador podem cancelar o temporizador se a plataforma não persistir estado. Atualizações muito espaçadas também limitam precisão. Se o sensor reporta a cada 15 min, exigir 2 min não cria informação intermediária. O requisito deve ser maior ou compatível com o intervalo de relatório e com a latência tolerada pela função.