Un sensor LoRaWAN envía unos pocos bytes, por ejemplo 01 0A 2B 64. Un códec sabe qué significan esos bytes para ese sensor y los convierte en valores con nombre, como temperature: 26.1 y humidity: 50. Hermetry decodifica cada uplink con un códec antes de que llegue a tus flujos.
Las cuatro opciones
| Opción | Se muestra como | Qué ocurre |
|---|---|---|
| Automático | Automático (por fabricante y puerto) | Hermetry elige el códec que reclama el fabricante del dispositivo y el FPort de la trama. Tus propios códecs tienen preferencia sobre los de la biblioteca. |
| Ninguno | Ninguno (payload sin decodificar a los flujos) | No se decodifica nada. El payload llega en hexadecimal bajo la clave raw. Decodifícalo tú mismo en un flujo. |
| Un códec de la biblioteca | Su nombre | Uno de los 106 códecs que incluye Hermetry. Consulta La biblioteca de códecs. |
| Tu propio códec | Su nombre, marcado como Yours | Un códec que publicaste, con id t.<name>. Consulta Escribe tu propio códec. |
Qué códec usa un dispositivo
Tanto el dispositivo como su perfil tienen un ajuste de códec. El códec efectivo se determina en este orden:
- La elección propia del dispositivo, salvo que sea Automático.
- Si no, el códec del perfil, salvo que sea Automático.
- Si no, la elección automática.
Configura el códec en el perfil cuando todos sus dispositivos sean el mismo sensor; configúralo en un dispositivo solo para excepciones.
Cómo funciona la elección automática
Los tres primeros bytes de un DevEUI identifican al fabricante del dispositivo (su OUI). Cada códec enumera los fabricantes (OUI) y los FPort que maneja. La elección automática toma el primer códec cuya lista de fabricantes contiene el OUI del dispositivo y cuya lista de FPort incluye el FPort de la trama (un códec sin lista de FPort acepta todos los puertos). Tus propios códecs se prueban primero, y después la biblioteca.
Si ningún códec reclama el dispositivo, no se decodifica nada y el payload llega como raw, igual que con Ninguno.
Cómo es un mensaje decodificado
Un uplink decodificado por un códec se convierte en un mensaje de dispositivo como este:
{
"temperature": 26.1,
"humidity": 50,
"battery": 3012,
"lora.rssi": -97,
"lora.snr": 7.5,
"lora.gw_count": 2,
"lora.dr": 5,
"lora.freq": 868100000,
"lora.fcnt_up": 1342
}Las claves lora.* se añaden cuando Añadir los valores de radio del perfil está activado. Los valores anidados se aplanan con puntos (probe.temperature), con un máximo de 4 niveles y 64 claves por mensaje. Un valor del códec llamado lora.… se renombra a dev.lora.… para que nunca choque con las claves del servidor de red. Las unidades que declara el códec viajan con los metadatos del mensaje.
Cuando la decodificación falla
Un uplink nunca falla por culpa de un códec:
| Situación | Resultado |
|---|---|
| Ningún códec reclama el dispositivo | El payload llega como raw (hexadecimal). |
| El códec no reconoce esta trama | El payload llega como raw. |
| El códec decodificó una parte y notificó errores | Llegan tanto los valores decodificados como raw. |
| El códec elegido fue retirado o eliminado | El dispositivo vuelve a la elección automática. |
raw contiene hasta 4.096 bytes de payload en hexadecimal.
Elige un códec
- Para un perfil: la pestaña LoRaWAN del perfil, Codec y después Guardar.
- Para un dispositivo: la pestaña LoRaWAN del dispositivo, Codec y después Guardar.
- Al añadir mediante la API:
codecId(auto,none, un id de la biblioteca o tu idt.).
Hermetry comprueba la elección al guardar. Un códec que no existe o que fue retirado se rechaza: Este códec no existe o fue retirado. Elige otro códec, o Automático. (codec_choice_unknown).
Adónde van los valores decodificados
Las claves decodificadas entran en tus flujos como cualquier telemetría de dispositivo. Solo se almacenan donde un flujo las guarda; el flujo raíz predeterminado almacena todas las claves. Las claves de salida del códec suelen llamarse como las nombra el fabricante del dispositivo. Para renombrarlas o convertirlas, consulta Limpieza de valores decodificados.
Encuentra los códecs
Abre Dispositivos, después el menú ⋯ y luego Códecs LoRaWAN. El panel lista los códecs de la biblioteca y los tuyos, y permite probar cualquier códec con un payload. Necesitas el permiso para ver los códecs LoRaWAN.