Les appareils physiques transmettent rarement la valeur exacte attendue par l'application : un compteur envoie des dixièmes de kilowatt, un octet d'état regroupe huit indicateurs, un relais utilise une logique inversée. Les transformations assurent la conversion entre la valeur du protocole et la valeur affichée, pour chaque objet. La page Santé surveille ensuite chaque liaison et transformation de l'installation.
Transformations
Chaque objet de communication peut intégrer une chaîne de transformation ordonnée. Ouvrez l'éditeur Transformations de l'objet depuis sa ligne, puis cliquez sur Ajouter une transformation et sélectionnez un type :
| Type | Fonction |
|---|---|
| Scale & Offset | Conversion linéaire : (valeur × facteur) + décalage. Conversions d'unités, mise à l'échelle de compteurs. |
| Invert Boolean | Inverse vrai et faux — pour les protocoles où 0 correspond à ON. |
| Bit Extract | Extrait une plage de bits d'un entier (bit de départ, nombre de bits, signé en option). |
| Bit Check | Teste un bit d'un entier et renvoie un booléen (inversion possible). |
| Value Map | Associe des valeurs discrètes à d'autres valeurs (remmappage enum), avec valeur par défaut et mode strict. |
| Clamp | Limite les valeurs à une plage définie (ou aux limites min/max de l'objet). |
| Threshold | Convertit un nombre en booléen (>, >=, <, <=, ==, != par rapport à un seuil, avec hystérésis). |
| Round | Arrondit selon une précision (arrondi, plancher, plafond, troncature). |
Chaque transformation possède une direction :
- Entrant — protocole → widget (ce que l'application affiche).
- Sortant — widget → protocole (ce qu'une commande envoie).
- Les deux — appliqué dans les deux sens lorsque l'opération est réversible.
Les chaînes s'exécutent dans l'ordre ; glissez-déposez pour réorganiser. Un aperçu en direct vous permet de saisir une valeur d'entrée et de visualiser immédiatement le résultat de la chaîne avec des exemples.
Validation. L'éditeur valide l'ensemble de la chaîne par rapport à l'objet et aux types de protocoles :
- Erreurs bloquantes (ex. facteur égal à zéro, type de sortie de chaîne incompatible avec l'objet) : doivent être résolues avant l'enregistrement.
- Avertissements (ex. conversion forcée ou avec perte possible) : permettent l'enregistrement mais maintiennent l'objet signalé sur la page Santé.
Quand une transformation est-elle nécessaire ?
L'espace Appareils signale lorsqu'une transformation est requise : boîte de dialogue d'incompatibilité DPT lors de la liaison KNX (voir « Intégration KNX »), et avertissement de type de données dans les paramètres de l'objet (voir « Paramètres d'objet, journalisation et notifications »). Tant que la transformation de conversion n'est pas configurée, l'objet apparaît sur la page Santé.
La page Santé
Ouvrez Santé depuis l'en-tête de la page Appareils. Elle répertorie chaque objet présentant une anomalie :
- une liaison protocole ↔ widget incompatible (une liaison dont les types ne correspondent pas) ;
- un problème de configuration de transformation ;
- une erreur d'exécution récente (une valeur dont la conversion a échoué à l'exécution).
Chaque ligne affiche l'objet, le nombre d'anomalies par catégorie (problèmes de configuration, erreurs d'exécution) ainsi que le détail de chaque problème. Depuis une ligne, vous pouvez :
- Ouvrir dans Appareils — accède directement à l'appareil pour corriger la liaison ou la chaîne.
- Effacer les erreurs d'exécution — efface les erreurs d'exécution enregistrées pour cet objet, ou pour tous les objets simultanément, afin de vérifier une correction à partir d'un état propre.
Lorsque tout fonctionne correctement, la page indique simplement Aucun problème détecté — tous les objets de widget sont sains.
💡 Conseil : Après la mise en service, ouvrez la page Santé une fois l'installation active pendant quelques heures : cela permet de repérer les incompatibilités qui n'apparaissent que lors du passage de valeurs réelles.
