Novedad: el cortafuegos de IA supervisa cada módulo y explica cada incidente con palabras sencillas. Vea cómo funciona

Añadir un dispositivo ABP

Registre un dispositivo LoRaWAN activado por personalización con su DevAddr y sus claves de sesión, y gestione sus contadores de trama.

Un dispositivo ABP (activación por personalización) no se une. Su dirección (DevAddr) y sus dos claves de sesión se configuran en el dispositivo, y envía con ellas desde su primera trama. Use ABP solo cuando el dispositivo no pueda hacer OTAA: OTAA es más seguro y más fácil de recuperar. Esta página explica cómo registrar un dispositivo ABP y cómo gestionar sus contadores de trama.

ABP es compatible con LoRaWAN 1.0.x (1.0.2, 1.0.3, 1.0.4). Necesita el permiso para añadir, editar y eliminar dispositivos LoRaWAN.

Lo que necesita

ValorFormato
DevEUI16 dígitos hexadecimales
JoinEUI16 dígitos hexadecimales (no se usa para unirse; 0000000000000000 sirve)
DevAddr8 dígitos hexadecimales, tal como están configurados en el dispositivo
NwkSKey (clave de sesión de red)32 dígitos hexadecimales
AppSKey (clave de sesión de aplicación)32 dígitos hexadecimales

El DevAddr debe pertenecer a esta red

Cada red LoRaWAN tiene un NetID, y los primeros bits de un DevAddr identifican la red. Las pasarelas de Hermetry reciben el NetID de la red y descartan las tramas cuyo DevAddr pertenece a otra red, por lo que Hermetry rechaza de antemano una dirección de ese tipo.

Si la dirección no encaja, Hermetry responde Este DevAddr no pertenece a esta red. Use una dirección con el prefijo NetID de la red. (devaddr_not_in_netid) y los detalles del error indican el NetID de la red. Con el NetID 000000, el DevAddr debe estar entre 00000000 y 01FFFFFF. Si su dispositivo vino con una dirección fuera de ese rango, configure un nuevo DevAddr en el dispositivo.

Un DevAddr solo puede ser usado por un dispositivo activo en su organización. Un segundo dispositivo con la misma dirección se rechaza: Otro dispositivo de este tenant ya usa este DevAddr. (devaddr_taken).

Añadir el dispositivo

  1. Abra Dispositivos y seleccione Nuevo dispositivo.
  2. Elija Dispositivo LoRaWAN.
  3. Establezca Activación en ABP (dirección y claves de sesión configuradas en el dispositivo). El formulario muestra una nota sobre los contadores de trama y los campos ABP.
  4. Complete Nombre, DevEUI, JoinEUI (AppEUI), DevAddr, NwkSKey (clave de sesión de red) y AppSKey (clave de sesión de aplicación), después Versión de LoRaWAN y Clase.
  5. Seleccione Añadir dispositivo.

El panel indica El dispositivo se ha añadido. Sus uplinks se reciben desde su primera trama.

Advertencia

Las claves de sesión se almacenan cifradas y no se vuelven a mostrar. Guárdelas en un lugar seguro.

Contadores de trama

Cada uplink lleva un contador de trama. El servidor de red acepta solo un contador que avanza (como máximo 16.384 de una vez). Una repetición solo se acepta como retransmisión del último uplink confirmado. Así se bloquean las tramas reproducidas.

En un dispositivo ABP esto importa:

  • Los contadores empiezan en 0 al añadir el dispositivo.
  • Muchos dispositivos ABP vuelven a iniciar su contador en 0 al reiniciarse o al cambiar la batería. Sus siguientes tramas parecen antiguas y se descartan, lo que aparece en el registro de tramas como Trama reproducida o Salto en el contador de tramas.
  • Hermetry nunca vuelve a sincronizar un contador por sí solo. La decisión es suya.

Restablecer los contadores tras reiniciar el dispositivo

  1. Asegúrese de que el dispositivo realmente reinició sus contadores (por ejemplo, se volvió a programar o se cambió la batería).
  2. Abra la pestaña LoRaWAN del dispositivo y seleccione Restablecer contadores.
  3. Confirme Restablecer los contadores de trama: «Úselo solo después de que el dispositivo haya reiniciado sus contadores. Hasta que el dispositivo vuelva a enviar, una trama antigua registrada de él podría aceptarse una vez. El restablecimiento queda registrado en el registro de auditoría.»

El contador del siguiente uplink se acepta desde 0 y el contador de downlink empieza en 0. La pestaña muestra Contadores restablecidos por última vez. La entrada de auditoría iot_lorawan.device.counters_reset registra los contadores que se sustituyeron.

Un dispositivo ABP no tiene el botón Restablecer sesión: no puede unirse, así que terminar su sesión lo dejaría sin conexión. Hermetry lo rechaza con Un dispositivo ABP no se une: su sesión no puede restablecerse. Restablezca sus contadores o asígnele nuevas claves de sesión.

Configuración de radio de un dispositivo ABP

Como un dispositivo ABP nunca se une, nadie le ha comunicado la configuración del perfil. Empieza con los valores por defecto de LoRaWAN 1.0.x para EU868: retardo de RX1 de 1 segundo, desplazamiento de data rate de RX1 0, RX2 en 869,525 MHz y DR0, y solo los tres canales por defecto. El servidor de red planifica los downlinks con estos valores y pide al dispositivo, mediante comandos MAC, que pase al retardo de RX1 del perfil (5 segundos por defecto). Hasta que el dispositivo lo confirme, los downlinks usan lo que el dispositivo realmente tiene.

Un restablecimiento de contadores también devuelve estos valores de radio a los valores por defecto.

Sustituir las claves de sesión

En la pestaña LoRaWAN, en Claves, introduzca el DevAddr (prerrellenado con el actual), la Nueva NwkSKey y la Nueva AppSKey, y seleccione Sustituir claves. Confirme: «Una nueva sesión empieza con los contadores en 0. Configure la misma dirección y claves en el dispositivo, o dejará de recibirse.» Los tres valores se cambian juntos; Hermetry rechaza un cambio parcial con Una nueva sesión ABP necesita el DevAddr, la NwkSKey y la AppSKey juntos.

A través de la API

POST /tenant/<tenantId>/api/iot/lorawan/devices
Content-Type: application/json

{
  "activation": "ABP",
  "name": "Meter 12",
  "devEui": "1122334455667712",
  "devAddr": "0100A3F1",
  "nwkSKey": "<32 hex digits>",
  "appSKey": "<32 hex digits>",
  "macVersion": "1.0.3",
  "class": "A"
}

Un cuerpo ABP con un appKey, o un cuerpo OTAA con claves de sesión, se rechaza. Restablezca los contadores con DELETE /tenant/<tenantId>/api/iot/lorawan/devices/<deviceId>/counters.