Nouveau : le pare-feu IA surveille toute la plateforme et explique chaque incident en termes simples. Découvrez comment ça marche

Le journal des trames

Le journal en direct des trames LoRaWAN de votre organisation : colonnes, types de trames, résultats et signification de chaque raison de rejet.

Le journal des trames indique ce que vos passerelles ont entendu et ce que le serveur réseau en a fait : jointures, liaisons montantes, liaisons descendantes 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, les plus récentes en premier, 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 dans l’onglet LoRaWAN d’un appareil (ses propres trames) et dans l’onglet d’une passerelle (Trames entendues par cette passerelle).

Vous devez disposer de l’autorisation 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é. Lorsqu’aucune trame n’a été reçue, le tableau indique No frames in the last day. Frames appear here as soon as a gateway hears one of your devices.

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

ColonneAffiche
HeureMoment où la trame a été traitée
TrameLe type de trame (voir ci-dessous)
AppareilLe nom de l’appareil, sinon son DevEUI, sinon le DevAddr en gris (une trame qui n’a pu être associée à aucun de vos appareils)
FCntLe compteur de trames
FPortLe port applicatif. 0 signifie commandes MAC uniquement.
DR / MHzDébit de données et fréquence, par exemple DR5 · 868.1
PasserellesNombre de passerelles ayant entendu la trame, avec le meilleur RSSI et le SNR : 2 · best -97 dBm / 7.5 dB
RésultatCe qui s’est passé (voir ci-dessous)

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

Types de trames

TypeSignification
Liaison montanteUne trame de données non confirmée émise par un appareil
Liaison montante confirméeUne trame de données dont l’appareil demande un accusé de réception
Demande de jointureUn appareil OTAA demandant à rejoindre le réseau
Acceptation de jointureLa réponse du serveur réseau à une demande de jointure
Liaison descendanteUne trame envoyée à un appareil : un accusé de réception, des commandes MAC ou vos données
RejetéeUne trame de données refusée par le serveur réseau

Résultats

RésultatSignification
TraitéeAcceptée et transmise
Envoyée via passerelle (RX1 / RX2 / RXC)Une liaison descendante ou une acceptation de jointure remise à cette passerelle dans cette fenêtre. RXC est une liaison descendante de classe C.
RetransmissionL’appareil a répété sa dernière liaison montante confirmée. Elle est de nouveau acquittée mais n’est pas livrée deux fois.
Raisons de rejetAffiché en rouge ; voir ci-dessous

Raisons de rejet

Trames de données

Affiché commeCodeSignificationQuoi vérifier
Adresse d’appareil inconnueunknown_devaddrAucune 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. Pour un appareil ABP : vérifiez son DevAddr.
Un appareil d’un autre réseauforeign_tenantL’adresse appartient à un appareil d’une autre organisation que votre passerelle a entendu.Rien ; c’est normal à proximité d’autres réseaux.
Échec du contrôle d’intégritémic_failedLe 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éereplayLe compteur de trames n’a pas avancé.Appareil ABP ayant redémarré ses compteurs : Réinitialiser les compteurs. Sinon, tentative de rejeu.
Saut du compteur de tramesfcnt_gapLe 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 une liaison montante LoRaWAN valide.Généralement du bruit radio ou un émetteur non LoRaWAN.

Demandes de jointure

Affiché commeCodeSignification
DevEUI inconnuunknown_deveuiLe DevEUI n’est pas enregistré et aucune fenêtre d’appairage ne correspond.
Un appareil d’un autre réseauforeign_tenantLe DevEUI appartient à une autre organisation.
AppKey incorrectejoin_mic_failedL’AppKey ne correspond pas à celle de l’appareil.
DevNonce déjà utilisédevnonce_replayLa protection contre le rejeu a refusé le DevNonce.
Ajout en cours par le mode appairagepairing_pendingUne fenêtre d’appairage a reconnu l’appareil et l’ajoute. Attendu une fois par appareil.
En attente d’approbationpending_approvalL’appairage l’a ajouté ; il attend l’approbation.
Appareil ABP ayant envoyé une demande de jointurenot_otaaL’appareil est enregistré en ABP mais tente une jointure OTAA.
join_eui_mismatch—Le JoinEUI diffère de celui 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 liaisons montantes et descendantes.

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 contient 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’une liaison montante traitée.