Los dispositivos reales rara vez entregan exactamente el valor que la aplicación necesita: un contador envía décimas de kilovatio, un byte de estado agrupa ocho indicadores, un relé utiliza lógica invertida. Las transformaciones convierten entre el valor del protocolo y el valor mostrado, por cada objeto. La página Health supervisa a continuación cada vinculación y transformación de la instalación.
Transformaciones
Cada objeto de comunicación puede incluir una cadena de transformaciones ordenada. Abra el editor de Transformaciones del objeto desde su fila, haga clic en Add Transformation y elija un tipo:
| Tipo | Qué hace |
|---|---|
| Scale & Offset | Conversión lineal: (valor × escala) + desplazamiento. Conversión de unidades, escalado de contadores. |
| Invert Boolean | Invierte verdadero y falso — para protocolos donde 0 significa ON. |
| Bit Extract | Extrae un rango de bits de un entero (bit inicial, número de bits, opcionalmente con signo). |
| Bit Check | Comprueba un bit de un entero y devuelve un booleano (opcionalmente invertido). |
| Value Map | Mapea valores discretos a otros valores (reasignación de enumeraciones), con valor por defecto opcional y modo estricto. |
| Clamp | Limita los valores a un rango (o al mínimo/máximo propio del objeto). |
| Threshold | Convierte un número en un booleano (>, >=, <, <=, ==, != respecto a un umbral, con histéresis opcional). |
| Round | Redondea a una precisión (redondeo, hacia abajo, hacia arriba, truncado). |
Cada transformación tiene una dirección:
- Incoming — protocolo → widget (lo que muestra la aplicación).
- Outgoing — widget → protocolo (lo que envía un comando).
- Both — se aplica en ambas direcciones cuando la operación es reversible.
Las cadenas se ejecutan en orden; arrastre para reordenar. Una vista previa en tiempo real le permite introducir un valor de entrada y ver el resultado de la cadena inmediatamente, con ejemplos.
Validación. El editor valida toda la cadena frente al objeto y los tipos de protocolo:
- Los problemas bloqueantes (por ejemplo, escala cero, salida de cadena incompatible con el tipo de objeto) deben corregirse antes de guardar.
- Las advertencias (por ejemplo, una conversión forzada o con posible pérdida) permiten guardar, pero mantienen el objeto marcado en la página Health.
Cuándo se necesita una transformación
El espacio de trabajo Devices le indica cuándo se requiere una transformación: el diálogo de discrepancia de DPT al vincular KNX (consulte «Integración KNX») y la advertencia de tipo de datos en los ajustes del objeto (consulte «Ajustes de objetos, registro y notificaciones»). Hasta que la transformación de conversión esté configurada, el objeto aparecerá en la página Health.
La página Health
Abra Health desde la cabecera de la página Devices. Enumera cada objeto que presenta un problema:
- un enlace incompatible entre protocolo y widget (una vinculación cuyos tipos no coinciden);
- un problema de configuración de transformación;
- un error reciente en tiempo de ejecución (un valor que no se pudo convertir en tiempo de ejecución).
Cada fila muestra el objeto, el recuento de problemas por tipo (errores de configuración, errores en tiempo de ejecución) y los detalles de cada problema. Desde una fila puede:
- Open in Devices — salta directamente al dispositivo para corregir la vinculación o la cadena.
- Clear runtime errors — borra los errores en tiempo de ejecución registrados para ese objeto, o para todos a la vez, permitiendo verificar una corrección desde cero.
Cuando todo funciona correctamente, la página muestra simplemente No problems found — all widget objects are healthy.
💡 Consejo: Tras la puesta en marcha, abra la página Health una vez que la instalación lleve unas horas en funcionamiento: detectará las discrepancias que solo aparecen cuando empiezan a fluir valores reales.
