Guías de ThinkLink / Modelos y datos
Modelos de objetos en ThinkLink: del payload a una telemetría fiable
Valide campos, unidades, casos límite y cambios de versión para que la telemetría sirva a alarmas, paneles e integraciones.
Defina significados y unidades antes de decodificar. Pruebe entradas normales, límite y anómalas, y compruebe campos visibles y mapeos de protocolo. No convierta datos ausentes, errores o mediciones aún no realizadas en lecturas normales.
Defina los campos antes de que otros sistemas los interpreten
Si cada dispositivo llama a la temperatura temp, T o temperature, paneles y alarmas necesitan adaptaciones repetidas. El modelo no solo convierte bytes: proporciona un significado estable y comprensible.
Documente nombre, significado, unidad, tipo, rango, representación de ausencia y versión del protocolo. Respete las convenciones existentes sin renombrar campos ya usados por un ejemplo. Distinga acumulados de valores instantáneos y estados de mediciones.
| Campo de ejemplo | Significado | Comprobar |
|---|---|---|
| temperature | Temperatura actual en °C | Signo, escala y códigos de error |
| humidity | Humedad relativa en %RH | Rango, precisión y ausencia |
| water_total | Agua acumulada en m³ | Acumulación, reinicios y desbordamiento |
| sample_time | Hora de la medición | Reloj del dispositivo o recepción en plataforma |
Decodifique según el protocolo, no por una sola muestra
Ante un payload real de AS, compruebe puerto, tipo, longitud y versión antes de aplicar orden de bytes, signo y escala. Un resultado aparentemente razonable no demuestra que la interpretación sea correcta.
ThinkLink dispone de scripts de modelo y una entrada de pruebas. Respete las estructuras documentadas de telemetría y atributos, los métodos auxiliares, los límites y el contexto de la versión utilizada. Las peticiones externas lentas dentro del decodificador introducen dependencias difíciles de controlar.
Prepare al menos tres grupos de muestras
Las muestras normales deben tener valores esperados contrastados con un instrumento. Las de límite deben cubrir temperaturas negativas, contadores máximos y combinaciones de estados permitidas. Las anómalas deben incluir tramas cortas, tipos desconocidos, errores y campos ausentes.
Acuerde cómo tratar datos inválidos: ignorarlos o conservar diagnósticos según el protocolo. No sustituya fallos de interpretación por cero, pues podría mostrar consumo nulo o cancelar alarmas por error. La tabla es un ejemplo de diseño, no un protocolo válido para cualquier equipo.
Compruebe conjuntamente la salida y la visualización
Si el script devuelve un campo que no aparece, revise campos de visualización, modelo seleccionado y vinculación antes de concluir que no hubo envío. Las salidas Modbus o BACnet necesitan sus propios mapeos; un campo de telemetría no los configura automáticamente.
Revise también las unidades. La unidad interna puede diferir de la mostrada, pero la conversión debe tener un único lugar claro. Convertir litros a metros cúbicos tanto en el script como en el panel altera el resultado.
Haga que las actualizaciones sean explicables y reversibles
Documente modelos de equipo y mensajes afectados por cada cambio. Ejecute las muestras guardadas, observe nuevos envíos de unos pocos dispositivos y compruebe que paneles y alarmas existentes siguen leyendo los campos históricos.
Si cambia el significado, cree preferentemente un campo con nombre claro y planifique la migración en lugar de reutilizar el anterior silenciosamente. Volver al script antiguo detiene errores nuevos, pero no repara automáticamente los datos ya guardados.
Preguntas frecuentes
¿Pueden varios dispositivos compartir un modelo?
Sí, dentro de un ámbito validado. Confirme protocolo, firmware y significado mediante muestras representativas, no solo por el nombre del equipo.
¿Decodificar correctamente garantiza alarmas y paneles correctos?
No. Compruebe por separado visualización, vinculación, unidades de umbrales y mapeos externos.
Referencias y lecturas adicionales
Esta guía se basa en las fuentes oficiales siguientes. Los diagramas explican el método; consulte la documentación de su versión para menús, campos y funciones exactos. Las fuentes enlazadas están en chino.