El registro de tramas muestra lo que han captado tus gateways y lo que hizo el servidor de red con ello: uniones, uplinks, downlinks y tramas descartadas con el motivo. Es el primer sitio donde mirar cuando un dispositivo no muestra datos.
Abrirlo
- Abre Dispositivos.
- Abre el menú ⋯ y selecciona Tramas LoRaWAN.
El cajón Registro de tramas muestra las últimas 200 tramas de tu organización, de la más reciente a la más antigua, y las vuelve a leer cada 5 segundos mientras está abierto. Selecciona el nombre de un dispositivo para abrir su pestaña LoRaWAN.
La misma tabla aparece en la pestaña LoRaWAN de un dispositivo (sus propias tramas) y en la pestaña de un gateway (Tramas que captó este gateway).
Necesitas el permiso para ver las tramas LoRaWAN en directo (usuarios por defecto).
Cuánto tiempo se conservan las tramas
El registro es breve a propósito: el último día, como máximo 1.000 tramas por organización. No se almacena en la base de datos ni se exporta. Cuando no se captó nada, la tabla dice No hay tramas en el último día. Las tramas aparecen aquí en cuanto un gateway capta una de tus dispositivos.
Para conservar el historial de señal, mantén las claves de radio lora.* en los mensajes de tus dispositivos y deja que tu flujo raíz las guarde.
Columnas
| Columna | Muestra |
|---|---|
| Hora | Cuándo se procesó la trama |
| Trama | El tipo de trama (véase más abajo) |
| Dispositivo | El nombre del dispositivo; si no lo tiene, su DevEUI; si no, el DevAddr en gris (una trama que no pudo asociarse a ningún dispositivo tuyo) |
| FCnt | El contador de tramas |
| FPort | El puerto de aplicación. 0 significa solo comandos MAC. |
| DR / MHz | Velocidad de datos y frecuencia, por ejemplo DR5 · 868.1 |
| Gateways | Cuántos gateways la captaron, con el mejor RSSI y SNR: 2 · mejor -97 dBm / 7.5 dB |
| Resultado | Lo que ocurrió (véase más abajo) |
La búsqueda encuentra nombres de dispositivo, DevEUI, DevAddr y palabras de resultado. Filtra por Trama y por Resultado. Ordena por hora, FCnt o FPort.
Tipos de trama
| Tipo | Significado |
|---|---|
| Uplink | Una trama de datos no confirmada enviada por un dispositivo |
| Uplink confirmado | Una trama de datos que el dispositivo quiere que se confirme |
| Solicitud de unión | Un dispositivo OTAA que pide unirse |
| Aceptación de unión | La respuesta del servidor de red a una unión |
| Downlink | Una trama enviada a un dispositivo: un acuse de recibo, comandos MAC o tus datos |
| Descartada | Una trama de datos que el servidor de red rechazó |
Resultados
| Resultado | Significado |
|---|---|
| Procesada | Aceptada y reenviada |
| Enviada por gateway (RX1 / RX2 / RXC) | Un downlink o una aceptación de unión entregados a ese gateway en esa ventana. RXC es un downlink de Clase C. |
| Retransmisión | El dispositivo repitió su último uplink confirmado. Se vuelve a confirmar, pero no se entrega dos veces. |
| Motivos de descarte | Se muestran en rojo; véase más abajo |
Motivos de descarte
Tramas de datos
| Se muestra como | Código | Significado | Qué revisar |
|---|---|---|---|
| Dirección de dispositivo desconocida | unknown_devaddr | Ninguna sesión de tus dispositivos usa este DevAddr. | Un dispositivo OTAA que no se ha unido (o cuya sesión se reinició) debe unirse. Un dispositivo ABP: comprueba su DevAddr. |
| Un dispositivo de otra red | foreign_tenant | La dirección pertenece a un dispositivo de otra organización que tu gateway captó. | Nada; es normal cerca de otras redes. |
| Fallo en la comprobación de integridad | mic_failed | El MIC de la trama no coincide con la clave de sesión. | ABP: el NwkSKey es distinto al del dispositivo. OTAA: el dispositivo puede estar usando una sesión antigua; haz que se vuelva a unir. |
| Trama repetida | replay | El contador de tramas no avanzó. | Un dispositivo ABP reinició sus contadores: Reiniciar contadores. Si no, un intento de repetición. |
| El contador de tramas saltó | fcnt_gap | El contador saltó más de 16.384. | Un dispositivo que perdió el estado de su contador. ABP: Reiniciar contadores. OTAA: haz que se vuelva a unir. |
bad_mtype, malformed | — | No es un uplink LoRaWAN válido. | Normalmente ruido de radio o un transmisor que no es LoRaWAN. |
Solicitudes de unión
| Se muestra como | Código | Significado |
|---|---|---|
| DevEUI desconocido | unknown_deveui | El DevEUI no está registrado y ninguna ventana de emparejamiento lo reconoció. |
| Un dispositivo de otra red | foreign_tenant | El DevEUI pertenece a otra organización. |
| AppKey incorrecta | join_mic_failed | La AppKey no coincide con la del dispositivo. |
| DevNonce usado anteriormente | devnonce_replay | La protección contra repeticiones rechazó el DevNonce. |
| Añadiendo mediante el modo de emparejamiento | pairing_pending | Una ventana de emparejamiento reconoció el dispositivo y lo está añadiendo. Es lo esperado, una vez por dispositivo. |
| Esperando aprobación | pending_approval | El emparejamiento lo añadió; espera aprobación. |
| Dispositivo ABP envió una solicitud de unión | not_otaa | El dispositivo está registrado como ABP pero intenta OTAA. |
join_eui_mismatch | — | El JoinEUI es distinto al almacenado. |
no_appkey | — | No hay ninguna AppKey almacenada para el dispositivo. |
mac_version_not_supported | — | El registro del dispositivo tiene una versión de LoRaWAN no compatible. |
Consulta Solución de problemas de uniones y Solución de problemas de uplinks y downlinks.
Privacidad entre organizaciones
Una trama descartada de un dispositivo de otra organización muestra solo su motivo. Nunca se te muestran su dirección, su DevEUI ni su propietario.
A través de la API
GET /tenant/<tenantId>/api/iot/lorawan/frames?deviceId=<id>&gatewayId=<id>&limit=200limit va de 1 a 1.000 (por defecto 200). Ambos filtros son opcionales. Cada trama incluye t, type, result, reason, deviceId, deviceName, devEui, devAddr, fCnt, fPort, dr, freq, gateways (gatewayId, eui, rssi, snr), chosenGatewayId, window y bytes cuando aplican, y los valores decodificados (decoded) de un uplink procesado.