Los codecs de biblioteca nombran sus claves de salida según el fabricante de cada dispositivo. La temperatura de un fabricante es temperature, la de otro es temperature_red; un sensor de aparcamiento informa "occupied" como texto, otro como 1. Si mezcla fabricantes, sus paneles y reglas de alarma serán más fáciles de gestionar cuando todos los dispositivos informen las mismas claves y en la misma forma. Esta página muestra dos formas de lograrlo: cambiar los valores en un flujo o cambiar el codec.
Opción 1: limpiar en un flujo
Cada mensaje de dispositivo pasa por un flujo raíz antes de almacenarse: el flujo raíz de su organización o el flujo raíz del perfil, cuando el perfil tiene uno. Añada los pasos de limpieza allí, antes del bloque Save telemetry. Entonces, lo que se almacena son los valores limpios.
Indicado para: renombrar claves, convertir unidades, transformar texto en números y eliminar claves que no desee, sin tocar el codec.
Buena práctica: asigne a cada tipo de sensor su propio perfil LoRaWAN con su propio flujo raíz, de modo que cada flujo gestione solo un formato de carga útil.
Renombrar una clave
Use el bloque Change con un paso move, o un paso set seguido de un paso delete:
| Paso | Ruta | Valor |
|---|---|---|
set | msg.payload.temperature | msg.payload.temperature_red |
delete | msg.payload.temperature_red |
Convertir un valor
Use el bloque Calculate. Ejemplos:
| Necesidad | Expresión | Destino |
|---|---|---|
| mV a V | round(msg.payload.battery / 1000, 2) | msg.payload.battery_v |
| °F a °C | round((msg.payload.temp_f - 32) * 5 / 9, 1) | msg.payload.temperature |
| Estado en texto a número | msg.payload.parking_status == "occupied" ? 1 : 0 | msg.payload.occupied |
| Texto numérico a número | number(msg.payload.level) | msg.payload.level |
La aritmética sobre texto falla, incluso con texto numérico como "21.5": convierta primero con number(...).
Eliminar claves que no necesita
Use un bloque Change con pasos delete, o delete keys con un patrón (por ejemplo debug_.*). El bloque Save telemetry también puede limitarse a las claves que indique.
Conservar las claves de radio
Las claves lora.* (lora.rssi, lora.snr y otras) llegan en el mismo msg.payload. Manténgalas si desea conservar el historial de recepción.
Dónde llegan los valores en el flujo
El disparador Device message envía la telemetría como un mensaje por registro, con un msg.payload plano de { clave: valor }. La salida anidada del codec ya está aplanada con puntos, de modo que un valor probe.temperature es la clave "probe.temperature". Lea la clave con su nombre completo.
Para ver los bloques en detalle, consulte Bloques de transformación de datos y Hosts, el flujo raíz y los flujos raíz de perfil.
Opción 2: cambiar el codec
Guarde una copia del codec de biblioteca y edítela. Consulte Escribir su propio codec.
Indicado para: obtener los nombres de clave y las unidades correctas en el origen, para que todos los flujos, paneles y exportaciones los vean.
| Cambio | Cómo en la tabla |
|---|---|
| Renombrar una clave | Cambie el nombre en field del campo. |
| Escalar un valor | Defina scale (y digits para los decimales). |
| Cambiar la etiqueta de unidad | Defina unit. |
| Texto en lugar de código | Use enum para asignar palabras a los números, o elimínelo para conservar el número. |
Tenga en cuenta la regla de revisiones: una vez publicado el codec, una nueva revisión no puede eliminar ni renombrar claves. Decida los nombres antes de publicar, o publique con un nuevo id.
Qué opción elegir
| Situación | Elija |
|---|---|
| Algunas claves que renombrar o convertir | Flujo |
| Muchos sensores de un modelo, y desea claves limpias en todas partes | Copia del codec |
| Combinar valores (por ejemplo, punto de rocío a partir de temperatura y humedad) | Flujo |
| El codec de biblioteca decodifica mal una trama | Copia del codec |
Texto, números y verdadero/falso
Mantenga cada clave con un tipo a lo largo del tiempo: una clave que a veces es número y a veces texto es difícil de graficar y comparar. Convierta en números o en verdadero/falso, en el flujo, los estados que desee graficar o comparar (abierto/cerrado, ocupado/libre). Consulte Valores numéricos, de texto y verdadero/falso.
Compruebe el resultado
- Abra la pestaña Telemetry de un dispositivo, o la salida de depuración del flujo, después de la siguiente transmisión (uplink).
- Compruebe los nombres de las claves y los valores.
- Actualice los paneles y las reglas de alarma con los nuevos nombres de clave.