Hermetry incluye una biblioteca de 106 codecs para sensores LoRaWAN comunes. Cada uno decodifica los payloads de un sensor o de una familia de sensores de un mismo fabricante. Los dispositivos en Automatic usan la biblioteca sin ninguna configuración cuando su fabricante y FPort coinciden con un codec de la biblioteca.
Abrir la biblioteca
- Abre Devices.
- Abre el menú ⋯ y selecciona LoRaWAN codecs.
El cajón lista todos los codecs que puedes usar: los de la biblioteca (Source: Library) y los tuyos (Source: Yours). Necesitas el permiso para ver los codecs LoRaWAN (users por defecto).
| Columna | Muestra |
|---|---|
| Id | El id del codec. Los ids de la biblioteca son nombres cortos formados por el fabricante y el modelo. Tus codecs empiezan por t. |
| Name | Lo que decodifica el codec, por ejemplo un sensor de temperatura y humedad |
| Vendor | El fabricante del dispositivo |
| Models | Los nombres de modelo que cubre el codec |
| FPorts | Los FPorts que decodifica; vacío significa todos los puertos |
| Kind | El formato de tabla, tlv o layout |
| Source | Library o Yours |
| Verified | Verified on a device o Not verified (decodificado a partir del formato publicado por el fabricante y comprobado con sus vectores de prueba) |
| Revision, Updated, Status | La revisión actual, cuándo cambió, Published o Withdrawn |
Busca por id, nombre, fabricante, modelo o código de fabricante (OUI).
Qué cubre la biblioteca
| Tipo de sensor | Ejemplos de valores |
|---|---|
| Calidad del aire interior | CO₂, materia particulada, formaldehído, ozono, temperatura, humedad, presión, luz |
| Temperatura y humedad | Sensores de sala, etiquetas, sondas (incluidos transmisores de PT100 y termopar), sensores de inserción y de doble sonda |
| Puertas, ventanas y contactos | Estado abierto/cerrado, contadores de aperturas |
| Pulsos y entradas digitales | Contadores de pulsos, estados de entrada |
| Corriente eléctrica | Pinzas de transformador de corriente (monofásicas y trifásicas), sensores de corriente multicanal, enchufes inteligentes y enchufes medidores |
| Fugas de agua | Fuga detectada, sensores de fuga de membrana y de sonda |
| Nivel y distancia | Distancia por ultrasonidos, radar y LiDAR, nivel de líquido capacitivo, nivel sumergible, transmisores de presión y nivel, nivel de llenado |
| Inclinación | Ángulo de inclinación y alarmas de inclinación |
| Suelo y agricultura | Humedad del suelo, temperatura, conductividad (CE), pH, humedad foliar |
| Gas y olores | Detectores de gas, detectores de olores |
| Presión y caudal | Presión en tubería, caudalímetros |
| Clima y entorno | Estaciones meteorológicas, nivel de luz, nivel de sonido |
| Localización | Localizadores de activos en exterior (GPS y Wi-Fi), localizadores de contenedores y tarjetas, credenciales, etiquetas de rastreo de contactos |
| Botones y alarmas | Botones de pánico, botones inteligentes y portátiles, credenciales de seguridad, paneles de escena |
| Ocupación y personas | Contadores de personas, ocupación de escritorios y puestos de trabajo, presencia por radar, detección de caídas, movimiento PIR |
| Aparcamiento | Sensores de plazas de aparcamiento |
| Control | Controladores de electroválvulas, controladores multiinterfaz, controladores de luz, termostatos, termostatos de radiador |
Hoy no hay en la biblioteca ningún sensor de vibración LoRaWAN. Para un sensor que falte, escribe tu propio codec.
Encuentra el codec para tu sensor
- Busca en el cajón el nombre de modelo del sensor, tal como aparece impreso en él.
- Abre el codec y revisa Models y FPorts.
- Revisa Makers (OUI): si tu DevEUI empieza por uno de estos códigos de seis dígitos, Automatic elige este codec por sí solo.
- Si tu DevEUI no empieza por ningún código de fabricante listado (por ejemplo, si el proveedor asignó sus propios DevEUI), elige el codec por nombre en el dispositivo o en el perfil.
Página de un codec
Abre un codec desde la lista para ver:
| Sección | Muestra |
|---|---|
| Codec | Id, revisión, Fingerprint (SHA-256), modelos, FPorts, fabricantes (OUI), origen y fuente |
| Keys it decodes | Cada clave de salida con su unidad, tomada de los vectores de prueba del propio codec |
| Revisions | Cada revisión publicada, con su tamaño y número de claves |
| Test bench | Prueba el codec con un payload real |
| La tabla del codec | La tabla en sí (solo lectura para los codecs de la biblioteca) |
La página también te recuerda: Downlinks are sent as raw hex or base64. Los codecs solo decodifican; consulta Sending downlinks.
Probar un codec
- Abre el codec y desplázate hasta Test bench.
- Introduce el FPort (1–255) y el Payload (hex) que envió el dispositivo (se admiten espacios, máximo 255 bytes). Copia el payload desde la herramienta del fabricante de tu dispositivo o desde un mensaje decodificado con None.
- Selecciona Decode.
El banco muestra la Key, el Value y la Unit decodificados, las Warnings y los Errors si los hay, y los Bytes left over cuando el codec no usó todos los bytes. The codec did not recognise this frame. significa que el codec no tiene ninguna regla para este FPort o forma de payload.
Nombres de las claves de salida
Los codecs de la biblioteca nombran sus claves como lo hace la documentación del fabricante del dispositivo, por ejemplo temperature_red o un estado de texto como "occupied". Distintos fabricantes usan nombres distintos para la misma magnitud. Si quieres una nomenclatura única en toda tu flota, consulta Cleaning up decoded values.
Cambios en la biblioteca
- La plataforma actualiza la biblioteca con el tiempo. Una nueva revisión de un codec puede añadir claves, pero nunca elimina ni renombra una, y nunca cambia la unidad de una clave. Tus flujos y paneles siguen funcionando.
- La plataforma puede Withdrawn un codec. Los dispositivos que lo habían elegido decodifican con la opción automática en su lugar.
- Los codecs de la biblioteca son de solo lectura para ti. Para cambiar uno, usa Save a copy; consulta Write your own codec.