I dispositivi reali raramente trasmettono esattamente il valore richiesto dall'applicazione: un contatore invia decimi di kilowatt, un byte di stato raggruppa otto flag, un relè utilizza una logica invertita. Le trasformazioni convertono il valore del protocollo nel valore visualizzato, per ciascun oggetto. La pagina Health monitora quindi ogni associazione (binding) e trasformazione nell'installazione.
Trasformazioni
Ogni oggetto di comunicazione può contenere una catena di trasformazione ordinata. Apri l'editor Transformations dell'oggetto dalla riga corrispondente, quindi fai clic su Add Transformation e seleziona una tipologia:
| Tipologia | Descrizione |
|---|---|
| Scale & Offset | Conversione lineare: (valore × scala) + offset. Conversioni di unità, scalatura dei contatori. |
| Invert Boolean | Inverte vero e falso — per i protocolli in cui 0 corrisponde a ON. |
| Bit Extract | Estrae un intervallo di bit da un intero (bit iniziale, numero di bit, opzionalmente con segno). |
| Bit Check | Verifica un singolo bit di un intero e restituisce un booleano (opzionalmente invertito). |
| Value Map | Mappa valori discreti su altri valori (rimappatura enum), con valore predefinito opzionale e modalità restrittiva (strict). |
| Clamp | Limita i valori a un intervallo (o ai valori min/max dell'oggetto stesso). |
| Threshold | Converte un numero in un booleano (>, >=, <, <=, ==, != rispetto a una soglia, con isteresi opzionale). |
| Round | Arrotonda a una determinata precisione (round, floor, ceiling, truncate). |
Ogni trasformazione ha una direzione:
- Incoming — protocollo → widget (ciò che l'applicazione visualizza).
- Outgoing — widget → protocollo (ciò che invia un comando).
- Both — applicata in entrambe le direzioni quando l'operazione è reversibile.
Le catene vengono eseguite in sequenza; trascina per riordinare. Un'anteprima in tempo reale consente di inserire un valore di input e visualizzare immediatamente l'output della catena, con esempi.
Validazione. L'editor convalida l'intera catena rispetto ai tipi dell'oggetto e del protocollo:
- I problemi bloccanti (ad es. fattore di scala pari a zero, output della catena incompatibile con il tipo di oggetto) devono essere corretti prima del salvataggio.
- Gli avvisi (ad es. una conversione forzata o potenzialmente con perdita di precisione) consentono il salvataggio ma mantengono l'oggetto segnalato nella pagina Health.
Quando è necessaria una trasformazione
L'area di lavoro Dispositivi segnala quando è necessaria una trasformazione: la finestra di dialogo per mancata corrispondenza del DPT durante l'associazione KNX (vedere "Integrazione KNX") e l'avviso sul tipo di dati nelle impostazioni dell'oggetto (vedere "Impostazioni oggetto, registrazione e notifiche"). Finché la trasformazione di conversione non viene configurata, l'oggetto appare nella pagina Health.
La pagina Health
Apri Health dall'intestazione della pagina Dispositivi. Elenca tutti gli oggetti che presentano un problema:
- un collegamento protocollo ↔ widget incompatibile (un'associazione i cui tipi non corrispondono);
- un problema di configurazione della trasformazione;
- un errore di runtime recente (un valore la cui conversione non è riuscita durante l'esecuzione).
Ogni riga mostra l'oggetto, il conteggio dei problemi per categoria (problemi di configurazione, errori di runtime) e i dettagli di ciascun problema. Da una riga è possibile:
- Apri in Dispositivi — passa direttamente al dispositivo per correggere l'associazione o la catena.
- Cancella errori di runtime — cancella gli errori di runtime registrati per quell'oggetto, o per tutti gli oggetti contemporaneamente, per verificare la correzione su una base pulita.
Quando tutto funziona correttamente, la pagina segnala semplicemente Nessun problema rilevato: tutti gli oggetti widget sono integri.
💡 Suggerimento: dopo la messa in servizio, apri la pagina Health dopo aver lasciato l'installazione attiva per alcune ore: rileva le discrepanze che emergono solo quando iniziano a transitare valori reali.
