Saltar para o conteúdo
Elausys

HyperVisu / Módulo Lógico

Validação, monitorização e segurança da lógica

As verificações ao guardar, os estados de funcionamento em tempo real, o teste por forçamento e as proteções de segurança integradas.

elausys · 03 agosto 2026
Nesta página

Validação e gravação

Ao guardar, é verificada cada função alterada:

  • Entrada obrigatória sem ligação — uma porta obrigatória não tem origem.
  • Incompatibilidade de tipo — um fio ou uma associação cujos tipos não são compatíveis (e sem conversão escolhida).
  • Destino proibido — uma saída apontada a um objeto no qual não pode escrever.
  • Ciclo sem bloco de temporização — um ciclo de realimentação que seria executado sem limite; insira um bloco de temporização para o tornar válido.

Guardar é sempre permitido — mas uma função que falha a validação é guardada desativada («desativada pela validação») e não é executada até corrigir o problema. O resultado é indicado («Guardado. Uma função tem problemas e permanece desligada.») e o painel de validação lista cada problema e aponta para o cartão, a porta ou o fio exatos.

📘 Nota: Isto é deliberado: pode guardar uma folha a meio no fim do dia sem estragar o que já está em execução.

Painel de validação aberto após guardar.

Monitorização e manutenção

Mude a tela para Monitor para ver a lógica em execução: os valores em tempo real aparecem nas portas e nos fios, e cada cartão ganha um rodapé de estado. O rodapé não mostra o nome do estado; leia-o assim:

O que o cartão mostraSignificado
Um visto verde com o último resultado (ou a hora da última execução, ou «nunca executada»)Funcionamento normal.
Um ícone de pausa com minutos e um nome de utilizador, p. ex. «42 min · anna», e um botão Resume nowUm forçamento manual colocou a função em pausa: alguém comandou manualmente um dos seus destinos (um residente moveu o estore). Os minutos indicam o tempo restante. Clique em Resume now apenas se o forçamento deva mesmo terminar.
Uma linha de texto vermelhaUm erro, nas palavras do motor — p. ex. «Input stale: …», que indica uma entrada vigiada cuja origem deixou de responder (ver «Logic Engine — Concepts & Canvas»).
Uma linha de texto âmbarEm execução, mas algo requer atenção — um conflito num objeto que a função define, ou algo que uma atualização do servidor deixou para revisão.
Uma etiqueta OFF no cabeçalho do cartãoA função está desligada — por si ou pela validação. Não é avaliada.
Um emblema Simulating no canto do cartãoUma entrada está forçada pelo Test-fire (ver abaixo); a entrada forçada está assinalada no cartão.

Histórico de execução. Selecione um cartão e clique em History para ler as suas decisões mais recentes. Os filtros são All, Runs, Writes, Errors, Suspensions e Loops. É escrita uma linha quando uma decisão muda, não a cada avaliação; uma execução mostra os valores de entrada e as saídas que produziram. São mantidas as 500 entradas mais recentes por função, e o registo não pode ser exportado. É a sua resposta a «porque é que os estores se moveram às 14:02?».

Test-fire / simulação. Para testar sem esperar pelas condições reais, force o valor de uma entrada:

  1. Selecione a função, clique em Test-fire e escolha o Input.
  2. Defina o Forced value e escolha Revert after: 1 minuto, 5 minutos, 15 minutos (predefinição) ou 1 hora.
  3. Clique em Force the value. A página muda para Monitor, o cartão mostra Simulating e a entrada forçada fica assinalada; a associação real não é alterada por baixo. Só uma entrada pode ser forçada de cada vez.
  4. Clique em End simulation na mesma caixa de diálogo para parar antes de o tempo terminar.

⚠️ Aviso: O Test-fire não é uma simulação sem efeitos. A função é avaliada com o valor forçado: as suas saídas são escritas nos dispositivos, as funções que leem as suas saídas também são executadas e as suas ações disparam. Só as ações da própria função testada ficam retidas, e as definidas como When it turns off ou Both ways disparam quando a simulação termina. Para testar sem tocar nos dispositivos, use Duplicate na função, remova todos os dispositivos e ações das saídas da cópia, ative a cópia e teste-a.

Uma função desligada ignora o Test-fire, embora a mensagem continue a indicar que a entrada foi forçada: ative-a e guarde primeiro. O servidor repõe o valor forçado por temporizador próprio — um separador do navegador fechado não pode deixar uma simulação em curso — e o início e o fim da simulação aparecem no histórico de execução.

Eliminar uma função. Delete mostra primeiro uma caixa de diálogo de impacto, que lista apenas o que é afetado: as funções que leem as suas saídas, os objetos que comanda, as ações que executa e os Widgets made from its outputs. Uma só caixa, Delete the materialised widgets too, abrange todos esses widgets: deixe-a por assinalar para os manter na aplicação, congelados no último valor, ou assinale-a para os eliminar com a função. Confirme com Delete the function.

Modo Monitor.

Proteções de segurança

O motor protege a instalação contra erros de lógica:

  • Interrupção de ciclos — um limite de profundidade de propagação impede que cadeias que fazem ciclo através dos dispositivos sejam executadas indefinidamente.
  • Limitação de frequência — uma função descontrolada (20 execuções em 10 segundos) é suspensa automaticamente durante 60 segundos e assinalada no modo Monitor, em vez de inundar o bus.
  • Dimensionamento — a recomendação indicativa é de cerca de 200 funções por instalação. Acima disso, prefira consolidar (um Calculated value com 8 entradas em vez de uma árvore de somas) e questione se parte da lógica não deve ficar nos próprios dispositivos.

📘 Nota: Estas proteções limitam os danos; não substituem um bom projeto. Tudo o que nunca deva falhar de forma insegura (vento, gelo) deve também ser protegido nos parâmetros do próprio atuador.

Perguntas frequentes

Posso guardar uma função inacabada?

Sim. Uma função que falha a validação é guardada desativada e não é executada até os problemas serem corrigidos.

Onde posso ver porque é que uma função atuou?

Selecione o respetivo cartão e clique em History para consultar as suas decisões mais recentes, com os valores de entrada e as saídas. São mantidas as 500 entradas mais recentes por função; o registo não pode ser exportado.

Um valor de teste forçado mantém-se se eu fechar o navegador?

Não. O servidor repõe-no automaticamente após a duração selecionada. A predefinição é 15 minutos e o máximo é uma hora. Até lá, o valor forçado comanda realmente as saídas para os dispositivos da função: o Test-fire não é uma simulação sem efeitos.

Porque é que uma função foi suspensa automaticamente?

Uma função que é executada 20 vezes em 10 segundos é suspensa durante 60 segundos para limitar a atividade excessiva. O modo Monitor assinala a situação.

Os limites de segurança da lógica substituem a proteção do atuador?

Não. A proteção crítica contra vento ou gelo deve ser também configurada nos parâmetros do próprio atuador.

Continuar a explorar

Encontre os outros guias deste produto na documentação.

Voltar a Módulo Lógico