Conecta tu primer sensor LoRaWAN

Esta página lleva una pasarela LoRaWAN y un sensor LoRaWAN desde la caja hasta las lecturas decodificadas en unos quince minutos. Usa la configuración más habitual: una pasarela que habla Basics Station y un sensor que se une por aire (OTAA). Cada paso enlaza con la página completa de la sección LoRaWAN.

Lo que necesitas

• El rol Admin (permiso para gestionar pasarelas y dispositivos LoRaWAN).
• Una pasarela EU868 que admita Basics Station (modo LNS), con acceso a su propia página de configuración. Las pasarelas que solo ejecutan el reenviador de paquetes UDP no son compatibles.
• Un sensor EU868 y su hoja del proveedor con el DevEUI, el JoinEUI (también llamado AppEUI) y la AppKey.
• Espacio para dos dispositivos más en tu plan: la pasarela y el sensor cuentan cada uno como un dispositivo.

Si tu pasarela es un router licenciado con radio LoRa, omite los pasos 1 y 2 y sigue Routers licenciados como pasarelas LoRaWAN.

1. Añadir la pasarela

1. Abre Dispositivos y selecciona Nuevo dispositivo.
2. Elige Pasarela LoRaWAN («Una pasarela Basics Station, por su EUI; su token se muestra una sola vez.»).
3. Introduce un Nombre (por ejemplo Roof, north side) y el EUI de la pasarela: 16 dígitos hexadecimales de la etiqueta de la pasarela o de su página web. Los espacios, - y : se eliminan automáticamente. La Región está fijada en EU868.
4. Selecciona Añadir pasarela.

El panel muestra los valores de Conectar la pasarela: la dirección LNS, la dirección de descubrimiento y la cabecera del token, con botones para descargar tc.uri, tc.trust y tc.key.

2. Configurar la pasarela

En la página de configuración propia de la pasarela:

1. Elige el modo de servidor de red Basics Station (LNS).
2. Define la dirección del servidor (tc.uri) como la dirección LNS, wss://<la dirección de tu organización>.<host del servidor de red>. Si la pasarela pide en su lugar una dirección de descubrimiento, usa la Dirección de descubrimiento.
3. Define el certificado del servidor (tc.trust): sube el archivo descargado o elige el almacén de certificados del sistema de la pasarela.
4. Define el token de autorización (tc.key) con la línea de la cabecera del token, o sube el tc.key descargado.
5. Guarda y reinicia el reenviador de la pasarela.

De vuelta en Hermetry, abre la pasarela desde Dispositivos y selecciona su pestaña LoRaWAN. En menos de un minuto el estado muestra En línea, y Ida y vuelta y Conectada desde se rellenan. Consulta Conectar una pasarela Basics Station.

3. Añadir el sensor

1. Abre Dispositivos > Nuevo dispositivo y elige Dispositivo LoRaWAN («Un dispositivo final, por su DevEUI, JoinEUI y AppKey.»).
2. Deja Activación en OTAA (se une con su AppKey).
3. Rellena Nombre, DevEUI, JoinEUI (AppEUI) (usa 0000000000000000 cuando la hoja no lo indique), AppKey (32 dígitos hexadecimales), Versión de LoRaWAN (1.0.3 salvo que la hoja indique otra cosa) y Clase (A para sensores con batería).
4. Selecciona Añadir dispositivo. El panel indica The device was added. It shows as joined after its first join request.

El sensor se añade con el perfil integrado LoRaWAN EU868 Class A OTAA (1.0.3). Solo el modo de emparejamiento añade dispositivos a un perfil de tu elección.

Consulta Añadir un dispositivo OTAA. Para sensores con claves de sesión fijas, consulta Añadir un dispositivo ABP.

4. Dejar que se una

Enciende el sensor o haz que se vuelva a unir (muchos sensores tienen un botón o un imán para ello). Abre la pestaña LoRaWAN del sensor: la insignia de unión junto al encabezado cambia a Unido tras una unión correcta. La unión y los primeros uplinks también aparecen en el registro de tramas: Dispositivos > ⋯ > Tramas LoRaWAN.

Consulta Cómo se une un dispositivo, paso a paso.

5. Revisar el codec

Un codec convierte los bytes del sensor en lecturas. Un dispositivo nuevo usa Automático (por fabricante y puerto): Hermetry elige el codec que reclama el fabricante del sensor (a partir de su DevEUI) y el FPort de la trama. Tus propios codecs se prueban antes que los 106 codecs de la biblioteca.

En la pestaña LoRaWAN del sensor, revisa Codec:

• Si se encontró un codec, mantén Automático.
• Si ningún codec reclama el sensor, la carga llega sin decodificar en hexadecimal bajo la clave raw. Elige el codec del sensor en la lista y selecciona Guardar, o usa Ninguno (carga bruta a los flujos) y decodifícala en un flujo.

Consulta Codecs: convertir bytes en valores y La biblioteca de codecs.

6. Ver las primeras lecturas

Abre la pestaña Telemetría del sensor. Tras el siguiente uplink, la tabla Últimos valores muestra las claves decodificadas, por ejemplo temperature, humidity y battery, además de las claves de radio lora.rssi, lora.snr y otras cuando el perfil las añade. La pestaña LoRaWAN muestra la Última recepción con las pasarelas que la oyeron.

Los sensores con batería suelen enviar solo cada 10 a 60 minutos. Consulta el registro de tramas si no quieres esperar.

Si no funciona

Síntoma	Primera comprobación
La pasarela nunca muestra En línea	Sigue ejecutando el reenviador UDP, la línea del token está incompleta o no confía en el certificado. Consulta la tabla de resolución de problemas en Conectar una pasarela Basics Station.
Nada del sensor en el registro de tramas	El sensor está fuera de alcance, no es un dispositivo EU868 o no ha intentado unirse.
Una unión se rechaza en el registro de tramas	AppKey o JoinEUI incorrectos, o un DevNonce reutilizado. Consulta Resolución de problemas de uniones.
Unido, pero solo llega raw	Ningún codec reclama el sensor. Elige uno en la pestaña LoRaWAN.
Los valores llegan con los nombres del fabricante	Renómbralos y conviértelos. Consulta Limpieza de valores decodificados.

Próximos pasos

• Añade varios sensores del mismo tipo a la vez con el modo de emparejamiento.
• Coloca la pasarela en el mapa: Estado de la pasarela, salud y mapa.
• Muestra las lecturas en un panel: Crea tu primer panel.