Le journal des trames

Le journal des trames montre ce que vos passerelles ont reçu et ce que le serveur réseau en a fait : jointures, uplinks, downlinks et trames rejetées avec la raison. C’est le premier endroit où regarder lorsqu’un appareil n’affiche pas de données.

Ouvrir

1. Ouvrez Appareils.
2. Ouvrez le menu ⋯ et sélectionnez Trames LoRaWAN.

Le tiroir Journal des trames affiche les 200 dernières trames de votre organisation, de la plus récente à la plus ancienne, et les relit toutes les 5 secondes tant qu’il est ouvert. Sélectionnez le nom d’un appareil pour ouvrir son onglet LoRaWAN.

Le même tableau apparaît sur l’onglet LoRaWAN d’un appareil (ses propres trames) et sur l’onglet d’une passerelle (Trames reçues par cette passerelle).

Vous avez besoin de la permission de consulter les trames LoRaWAN en direct (utilisateurs par défaut).

Durée de conservation des trames

Le journal est volontairement court : le dernier jour, au maximum 1 000 trames par organisation. Il n’est pas stocké dans la base de données et n’est pas exporté. Lorsque rien n’a été reçu, le tableau affiche Aucune trame au cours du dernier jour. Les trames apparaissent ici dès qu’une passerelle reçoit l’un de vos appareils.

Pour conserver l’historique du signal, gardez les clés radio lora.* dans les messages de vos appareils et laissez votre flux racine les enregistrer.

Colonnes

Colonne	Affiche
Heure	Moment où la trame a été traitée
Trame	Le type de trame (voir ci-dessous)
Appareil	Le nom de l’appareil, sinon son DevEUI, sinon le DevAddr en gris (une trame qu’aucun de vos appareils n’a pu identifier)
FCnt	Le compteur de trames
FPort	Le port applicatif. 0 signifie commandes MAC uniquement.
DR / MHz	Débit de données et fréquence, par exemple DR5 · 868.1
Passerelles	Nombre de passerelles ayant reçu la trame, avec le meilleur RSSI et SNR : 2 · meilleur -97 dBm / 7.5 dB
Résultat	Ce qui s’est passé (voir ci-dessous)

La recherche trouve les noms d’appareils, les DevEUI, les DevAddr et les mots de résultat. Filtrez par Trame et par Résultat. Triez par heure, FCnt ou FPort.

Types de trames

Type	Signification
Uplink	Une trame de données non confirmée envoyée par un appareil
Uplink confirmé	Une trame de données dont l’appareil demande un accusé de réception
Demande de jointure	Un appareil OTAA demandant à rejoindre le réseau
Acceptation de jointure	La réponse du serveur réseau à une demande de jointure
Downlink	Une trame envoyée à un appareil : un accusé de réception, des commandes MAC ou vos données
Rejetée	Une trame de données refusée par le serveur réseau

Résultats

Résultat	Signification
Traitée	Acceptée et transmise
Envoyée via passerelle (RX1 / RX2 / RXC)	Un downlink ou une acceptation de jointure remis à cette passerelle dans cette fenêtre. RXC est un downlink de classe C.
Retransmission	L’appareil a répété son dernier uplink confirmé. Il est de nouveau acquitté mais n’est pas livré deux fois.
Raisons de rejet	Affiché en rouge ; voir ci-dessous

Raisons de rejet

Trames de données

Affiché comme	Code	Signification	Quoi vérifier
Adresse d’appareil inconnue	unknown_devaddr	Aucune session de vos appareils n’utilise ce DevAddr.	Un appareil OTAA qui n’a pas rejoint le réseau (ou dont la session a été réinitialisée) doit rejoindre. Un appareil ABP : vérifiez son DevAddr.
Un appareil d’un autre réseau	foreign_tenant	L’adresse appartient à un appareil d’une autre organisation que votre passerelle a reçu.	Rien à faire ; c’est normal à proximité d’autres réseaux.
Échec du contrôle d’intégrité	mic_failed	Le MIC de la trame ne correspond pas à la clé de session.	ABP : le NwkSKey diffère de celui de l’appareil. OTAA : l’appareil utilise peut-être une ancienne session ; faites-le rejoindre à nouveau.
Trame rejouée	replay	Le compteur de trames n’a pas avancé.	Appareil ABP ayant redémarré ses compteurs : Réinitialiser les compteurs. Sinon, une tentative de rejeu.
Saut du compteur de trames	fcnt_gap	Le compteur a sauté de plus de 16 384.	Un appareil ayant perdu l’état de son compteur. ABP : Réinitialiser les compteurs. OTAA : faites-le rejoindre à nouveau.
bad_mtype, malformed	—	Pas un uplink LoRaWAN valide.	Généralement du bruit radio ou un émetteur non LoRaWAN.

Demandes de jointure

Affiché comme	Code	Signification
DevEUI inconnu	unknown_deveui	Le DevEUI n’est pas enregistré et aucune fenêtre d’appairage ne correspond.
Un appareil d’un autre réseau	foreign_tenant	Le DevEUI appartient à une autre organisation.
AppKey incorrecte	join_mic_failed	L’AppKey ne correspond pas à celle de l’appareil.
DevNonce déjà utilisé	devnonce_replay	La protection contre le rejeu a refusé le DevNonce.
En cours d’ajout par le mode appairage	pairing_pending	Une fenêtre d’appairage a reconnu l’appareil et est en train de l’ajouter. Attendu une fois par appareil.
En attente d’approbation	pending_approval	L’appairage l’a ajouté ; il attend l’approbation.
Appareil ABP ayant envoyé une demande de jointure	not_otaa	L’appareil est enregistré en ABP mais tente une jointure OTAA.
join_eui_mismatch	—	Le JoinEUI diffère de celui qui est enregistré.
no_appkey	—	Aucune AppKey n’est enregistrée pour l’appareil.
mac_version_not_supported	—	La fiche de l’appareil indique une version LoRaWAN non prise en charge.

Voir Dépannage des jointures et Dépannage des uplinks et downlinks.

Confidentialité entre organisations

Une trame rejetée d’un appareil d’une autre organisation n’affiche que sa raison. Son adresse, son DevEUI et son propriétaire ne vous sont jamais montrés.

Via l’API

GET /tenant/<tenantId>/api/iot/lorawan/frames?deviceId=<id>&gatewayId=<id>&limit=200

limit va de 1 à 1 000 (par défaut 200). Les deux filtres sont facultatifs. Chaque trame comporte t, type, result, reason, deviceId, deviceName, devEui, devAddr, fCnt, fPort, dr, freq, gateways (gatewayId, eui, rssi, snr), chosenGatewayId, window et bytes lorsqu’ils s’appliquent, ainsi que les valeurs décodées (decoded) d’un uplink traité.