Una solución lista para usar espera ciertas claves de telemetría, atributos y relaciones. Es probable que tus dispositivos nombren las cosas de otra manera: temp en lugar de air_temp, door como texto en lugar de door_open como verdadero/falso, o la presión en pascales en lugar de bar. Esta página muestra cómo encajar todo sin reescribir la solución y qué más necesita una solución de tu parte.
Elige un enfoque
| Enfoque | Ideal cuando | Esfuerzo |
|---|---|---|
| 1. Limpiar en el flujo raíz | Muchos dispositivos de un mismo tipo envían los mismos nombres | Un solo flujo, y luego cada tablero y regla funciona sin cambios |
| 2. Cambiar las tarjetas | Solo intervienen pocas tarjetas, o de todos modos usas un tablero de plantilla | Editar las claves de cada tarjeta |
| 3. Cambiar el codec (LoRaWAN) | El sensor es LoRaWAN y su codec nombra las claves a su manera | Guardar una copia del codec con otros nombres de salida |
| 4. Poner tus dispositivos en los perfiles de la solución | Tus dispositivos pueden enviar directamente las claves de la solución (controlas el firmware) | Ninguno por parte de Hermetry |
El enfoque 1 es la opción habitual: los datos almacenados coinciden entonces con los perfiles de la solución, de modo que las reglas de alarma, tableros y gráficos funcionan, y puedes mezclar fabricantes de dispositivos.
1. Limpiar en el flujo raíz
Cada mensaje de dispositivo pasa por un flujo raíz antes de almacenarse: la raíz propia del perfil si existe, o si no, el flujo raíz de la organización. Coloca los pasos de limpieza antes de Guardar telemetría.
- Asigna a los dispositivos de un mismo tipo su propio perfil de dispositivo, o usa el perfil de la solución.
- En Automatización, crea un flujo en el host IoT a partir de la plantilla Flujo raíz predeterminado y asígnalo como raíz de ese perfil. Consulta Hosts, el flujo raíz y los flujos raíz de perfil.
- Entre Mensajes de dispositivos y Reglas de alarma, añade los pasos siguientes.
- Prueba con un mensaje grabado y luego despliega.
Coloca los pasos antes de Reglas de alarma, para que las reglas vean también las claves limpias.
Renombrar una clave
Un bloque Cambiar con dos pasos, por ejemplo para convertir temp en air_temp:
| Paso | Ruta | Valor |
|---|---|---|
set | msg.payload.air_temp | msg.payload.temp |
delete | msg.payload.temp |
Convertir un valor
Un bloque Calcular, un destino por valor:
| Necesidad | Expresión | Destino |
|---|---|---|
°F a °C (air_temp) | round((msg.payload.temp_f - 32) * 5 / 9, 1) | msg.payload.air_temp |
| Estado de puerta en texto a verdadero/falso | msg.payload.door == "open" | msg.payload.door_open |
| Código de evento de un localizador al término de la solución | msg.payload.ev == 3 ? "fall" : (msg.payload.ev == 7 ? "sos" : "normal") | msg.payload.event |
| Texto numérico a número | number(msg.payload.level) | msg.payload.level_cm |
La aritmética sobre texto falla, incluso con texto numérico como "21.5": convierte primero con number(...). Consulta Bloques de transformación de datos y Limpieza de valores decodificados.
Eliminar las claves que no necesitas
Un bloque Cambiar con pasos delete, o limita Guardar telemetría a las claves que indiques. Menos claves te alejan del límite de claves de tu plan; consulta Claves de telemetría.
Nota
La limpieza cambia lo que se almacena, no lo que se cuenta: el mensaje cuenta para tu cuota mensual en cuanto llega. Consulta Cuota de mensajes y uso.
2. Cambiar las tarjetas
Para leer tus claves directamente, abre el tablero en modo Personalizar, abre la configuración de una tarjeta y elige tu clave en su campo de datos. Los gráficos, tablas y mapas tienen cada uno sus propias listas de claves. Un parámetro del tablero, como Depósitos o Controladores de sitio, selecciona dispositivos por perfil: abre Gestionar parámetros… y añade tu perfil, para que tus dispositivos aparezcan en el tablero.
Cambia una copia en lugar del tablero instalado: Duplícalo primero. Cuando Hermetry actualiza una solución, las tarjetas del tablero instalado se vuelven a escribir (consulta Instalar una solución).
3. Usar los límites de la solución
Las reglas de alarma comparan las lecturas con los atributos de servidor de cada dispositivo. Tus dispositivos también los necesitan:
| Solución | Atributos en cada dispositivo |
|---|---|
| Sitio de agua | Depósito: lowLevelThreshold, highLevelThreshold. Estación de bombeo: minPressure |
| Sitios remotos | Controlador de sitio: highTempThreshold, lowTempThreshold, highHumThreshold, lowHumThreshold |
| Regiones de sensores | maxTempThreshold, minTempThreshold, warnTempThreshold, maxHumThreshold, minHumThreshold, warnHumThreshold |
| Seguimiento de personal | forbiddenZone |
| Estaciones meteorológicas | Ninguno |
Un dispositivo sin atributo no es comprobado por la regla que lo lee. Establece los atributos:
- a mano, en la pestaña Atributos del dispositivo (ámbito Servidor),
- en lote, con columnas
attr:<key>en una importación de dispositivos (consulta Importar dispositivos en lote), - desde otro sistema, con
POST /api/iot/devices/{deviceId}/attributes/server(consulta API de telemetría y atributos).
4. Ubicaciones y relaciones
Algunas páginas encuentran dispositivos a través del modelo del sitio. Recréalo para tus propios dispositivos:
| Solución | Lo que necesita el tablero | Cómo |
|---|---|---|
| Sitio de agua | Depósitos y estaciones colocados en una zona bajo el sitio; cada depósito CONTROLS su estación de bombeo | Coloca los dispositivos; añade la relación del depósito a la estación |
| Sitios remotos | Controlador y pasarela UPS colocados en el sitio; la pasarela UPS FEEDS al controlador; cámaras colocadas en el sitio | Coloca los dispositivos; añade la relación de la UPS al controlador |
| Regiones de sensores | Sensores colocados en una región; el atributo floorPlan de la región; la estación etiquetada como Weather station | Coloca los dispositivos; establece el atributo y la etiqueta |
| Seguimiento de personal | Activos de zona con los nombres exactos con que los localizadores los reportan | Crea activos de tipo Zone con esos nombres |
Consulta Colocar dispositivos y Relaciones.
5. Nombra bien los dispositivos
Los tableros muestran los nombres de los dispositivos en títulos, tablas, mapas y textos de alarma («Alarma abierta en nombre: …»). Nombra cada dispositivo según lo que es y dónde está (Refugio de la colina, Depósito 3 Norte), no según su número de serie. El tablero de regiones de sensores también usa la etiqueta del dispositivo en el mapa.
Lista de comprobación
- Tus dispositivos envían las claves de la solución, directamente o tras la limpieza del flujo raíz. Comprueba la pestaña Telemetría de un dispositivo.
- Cada dispositivo tiene sus atributos de límite.
- Los dispositivos están colocados y las relaciones existen.
- Los parámetros de perfil del tablero incluyen tus perfiles.
- La lista de perfiles del flujo de notificación incluye tus perfiles, sus destinatarios son correctos y está activado.
- Se eliminan los dispositivos de muestra que ya no necesitas.
Solución de problemas
| Síntoma | Comprobar |
|---|---|
| Una tarjeta permanece vacía | El nombre de la clave en la pestaña Telemetría del dispositivo, exactamente, incluidas mayúsculas y minúsculas. Consulta Un panel no muestra datos. |
| Un gráfico está vacío pero la tarjeta de valor muestra un valor | La clave es texto o verdadero/falso: almacena una copia numérica |
| No se abre ninguna alarma | Falta el atributo de límite, o la limpieza se ejecuta después de Reglas de alarma |
| Los datos se detuvieron después de asignar una raíz de perfil | La nueva raíz no tiene Guardar telemetría. Consulta Los datos no llegan. |