Os dispositivos reais raramente transmitem o valor exato pretendido pela aplicação: um contador envia décimos de quilowatt, um byte de estado agrupa oito flags, um relé utiliza lógica invertida. As transformações convertem entre o valor do protocolo e o valor apresentado, por objeto. A página Health monitoriza depois todas as associações e transformações da instalação.
Transformações
Cada objeto de comunicação pode conter uma cadeia de transformações ordenada. Abra o editor de Transformations a partir da respetiva linha do objeto, clique em Add Transformation e selecione um tipo:
| Tipo | Função |
|---|---|
| Scale & Offset | Conversão linear: (valor × escala) + offset. Conversões de unidades, escalonamento de contadores. |
| Invert Boolean | Inverte verdadeiro e falso — para protocolos onde 0 significa ON (ligado). |
| Bit Extract | Extrai um intervalo de bits de um número inteiro (bit inicial, número de bits, opcionalmente com sinal). |
| Bit Check | Testa um bit de um número inteiro e devolve um booleano (opcionalmente invertido). |
| Value Map | Mapeia valores discretos para outros valores (remapeamento de enum), com predefinição opcional e modo estrito. |
| Clamp | Limita valores a um intervalo (ou aos valores mín./máx. do próprio objeto). |
| Threshold | Converte um número num booleano (>, >=, <, <=, ==, != face a um limiar, com histerese opcional). |
| Round | Arredonda para uma precisão específica (round, floor, ceiling, truncate). |
Cada transformação tem uma direção:
- Incoming — protocolo → widget (o que a aplicação apresenta).
- Outgoing — widget → protocolo (o que um comando envia).
- Both — aplicada em ambas as direções quando a operação é reversível.
As cadeias são executadas por ordem; arraste para reordenar. Uma pré-visualização em tempo real permite introduzir um valor de entrada e verificar imediatamente o resultado da cadeia, com exemplos práticos.
Validação. O editor valida toda a cadeia relativamente ao tipo de objeto e aos tipos de protocolo:
- Erros de bloqueio (por exemplo, escala igual a zero, saída da cadeia incompatível com o tipo de objeto) têm de ser corrigidos antes de guardar.
- Avisos (por exemplo, uma conversão forçada ou com eventual perda de precisão) permitem guardar, mas mantêm o objeto assinalado na página Health.
Quando é necessária uma transformação
O espaço de trabalho Devices indica quando uma transformação é obrigatória: a caixa de diálogo de incompatibilidade de DPT ao associar KNX (consulte “Integração KNX”) e o aviso de tipo de dados nas definições do objeto (consulte “Definições de Objeto, Registo e Notificações”). Até que a transformação de conversão esteja configurada, o objeto surgirá na página Health.
A página Health
Abra o separador Health a partir do cabeçalho da página Devices. Esta página lista todos os objetos com problemas:
- uma ligação incompatível entre protocolo ↔ widget (uma associação cujos tipos de dados não coincidem);
- um problema de configuração da transformação;
- um erro de execução recente (um valor cuja conversão falhou em tempo de execução).
Cada linha apresenta o objeto, a contagem de problemas por categoria (erros de configuração, erros de execução) e os detalhes de cada ocorrência. A partir de cada linha pode:
- Open in Devices — aceder diretamente ao dispositivo para corrigir a associação ou a cadeia.
- Clear runtime errors — limpar os erros de execução registados para esse objeto, ou para todos os objetos em simultâneo, permitindo validar a correção com o registo limpo.
Quando o sistema não apresenta falhas, a página indica simplesmente No problems found — all widget objects are healthy.
💡 Dica: Após o comissionamento, abra a página Health depois de a instalação estar em funcionamento durante algumas horas: este procedimento permite detetar incompatibilidades que só surgem com o fluxo real de valores.
