La mayoría de los sensores LoRaWAN usan OTAA (activación por aire): el dispositivo se une a la red con su AppKey, y el servidor de red le asigna una sesión nueva. Esta página muestra cómo registrar un dispositivo de este tipo. Para dispositivos que vienen con claves de sesión fijas, consulte Añadir un dispositivo ABP. Para añadir muchos dispositivos que comparten una misma clave, consulte Modo de emparejamiento.
Necesita el permiso para añadir, editar y eliminar dispositivos LoRaWAN (los administradores lo tienen por defecto).
Lo que necesita del proveedor del dispositivo
| Valor | También llamado | Formato |
|---|---|---|
| DevEUI | Device EUI | 16 dígitos hexadecimales |
| JoinEUI | AppEUI (en LoRaWAN 1.0.x) | 16 dígitos hexadecimales. Muchos dispositivos usan 0000000000000000. |
| AppKey | Clave de aplicación | 32 dígitos hexadecimales |
| Versión de LoRaWAN | Versión MAC | 1.0.2, 1.0.3 o 1.0.4 |
| Clase | — | A (batería) o C (alimentado por red, siempre escuchando) |
Estos valores están en la etiqueta del dispositivo, en una hoja que vino con él o en el portal del proveedor. El dispositivo debe ser un dispositivo EU868.
Añadir el dispositivo
- Abra Dispositivos y seleccione Nuevo dispositivo.
- Elija Dispositivo LoRaWAN («Un dispositivo final, identificado por su DevEUI, JoinEUI y AppKey.»).
- Rellene el formulario:
| Campo | Qué introducir | Reglas |
|---|---|---|
| Activación | OTAA (se une con su AppKey) | Por defecto |
| Nombre | Un nombre que reconozca. | Obligatorio, como máximo 128 caracteres |
| DevEUI | El EUI del dispositivo. | 16 dígitos hexadecimales; no todos ceros, no todos F |
| JoinEUI (AppEUI) | El JoinEUI. Use 0000000000000000 cuando el dispositivo no tenga uno. | 16 dígitos hexadecimales. Se rellena previamente con ceros. |
| AppKey | La clave de 32 dígitos. | 32 dígitos hexadecimales |
| Versión de LoRaWAN | La versión del dispositivo. | 1.0.2, 1.0.3 (por defecto), 1.0.4 |
| Clase | A (batería, responde tras cada uplink) o C (alimentado por red, siempre escuchando) | A por defecto |
Los espacios, - y : en los EUI y claves se eliminan automáticamente.
- Seleccione Añadir dispositivo.
El panel indica El dispositivo se ha añadido. Aparecerá como unido tras su primera solicitud de unión. Seleccione Abrir el dispositivo para ir a su pestaña LoRaWAN, o Añadir otro para vaciar el formulario.
- Encienda el dispositivo o haga que se vuelva a unir (muchos dispositivos tienen un botón o un imán para ello). Cuando la unión se realice correctamente, la insignia de unión en su pestaña LoRaWAN mostrará Unido.
Advertencia
La AppKey se guarda cifrada y no se vuelve a mostrar. Conserve la hoja del proveedor. Solo una persona con el permiso independiente para revelar AppKeys puede leerla, a través de la API, y cada revelación queda registrada en el registro de auditoría.
Lo que crea Hermetry
| Creado | Detalles |
|---|---|
| Un dispositivo | Con el perfil integrado LoRaWAN EU868 Class A OTAA (1.0.3). Cuenta como un dispositivo para su límite. No tiene token de acceso: los dispositivos LoRaWAN nunca se conectan a la plataforma por sí mismos. |
| Un registro LoRaWAN | DevEUI, JoinEUI, versión, clase, la AppKey cifrada y el códec Automático. |
| Una reserva de DevEUI en toda la plataforma | El DevEUI queda ahora reservado para su organización. |
Los ajustes de radio (retardo RX1, ADR) proceden del perfil. Consulte Perfiles de dispositivo LoRaWAN.
Errores
| Mensaje | Causa |
|---|---|
| 16 dígitos hexadecimales. | El DevEUI o el JoinEUI tiene una longitud incorrecta o caracteres no válidos. |
| 32 dígitos hexadecimales. | La AppKey tiene una longitud incorrecta o caracteres no válidos. |
| Dé un nombre al dispositivo. | El nombre está vacío. |
Este DevEUI ya está registrado. (deveui_taken) | Otro dispositivo de la plataforma tiene este DevEUI. Hermetry no indica dónde. |
| Esta versión de LoRaWAN aún no es compatible. Use 1.0.2, 1.0.3 o 1.0.4. | Se envió LoRaWAN 1.1 a través de la API. |
| Se ha alcanzado el límite de dispositivos de su plan. | No hay espacio para un dispositivo más. |
Si está seguro de que el DevEUI es suyo y aparece como «ya registrado», compruebe si se añadió antes en su propia organización, o mediante el modo de emparejamiento.
Cambiar la AppKey más adelante
En la pestaña LoRaWAN del dispositivo, en Claves, escriba la Nueva AppKey y seleccione Reemplazar claves. Confirme Reemplazar las claves: «El dispositivo debe volver a unirse con la nueva AppKey. Configure la misma clave en el dispositivo, o dejará de ser escuchado.» Una nueva AppKey también borra el historial de DevNonce del dispositivo, por lo que vuelve a empezar. Consulte La pestaña LoRaWAN del dispositivo.
Añadir un dispositivo a través de la API
POST /tenant/<tenantId>/api/iot/lorawan/devices
Content-Type: application/json
{
"name": "Cold room 3",
"devEui": "1122334455667701",
"joinEui": "0000000000000000",
"appKey": "2B7E151628AED2A6ABF7158809CF4F3C",
"macVersion": "1.0.3",
"class": "A",
"codecId": "auto",
"anyJoinEui": false
}Solo name, devEui y appKey son obligatorios; los demás tienen los valores por defecto indicados. La respuesta nunca contiene la AppKey; incluye hasAppKey: true. Consulte la API LoRaWAN.